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UiHUp 

Distributed Network Operating System 
Software Manuals Summary 

Concepts and Facilities 

Presents an overview of DNOS with topics grouped Into functions of the operating system. Ail new users 
(or evaluators) of DNOS should read this manual. 

Operations Guide 

Provides the Information necessary to perform dally tasks at a Tl 990 Computer Installation using DNOS. 
Step-by-step procedures are presented for such ;asks aV operating peripherals, Initializing the system, 
backing up the system, and manipulating disk flleis. 

System Command Interpreter (SCI) Reference Manual 

Describes how to use SCI In both Interactive anij batch jobs. Command procedures and primitives are 
described, followed by a detailed presentation of all SCI commands In alphabetical order for easy 
reference. 

Text Editor Reference Manual 

Shows how to use the Text Editor Interactively on DNOS and Includes a detailed description of each of the 
editing commands and function keys. ^ 

Messages and Codes Reference Manual 

Lists the error messages. Informative messages, md error codes reported by DNOS. 

Online Diagnostics and System Log Analysis Tasks Ussr’s Guide 

Provides the Information necessary to execute tfie online diagnostic tasks and the system log analysis 
tasks and to interpret the results. 

Master Index to Operating System Manuals 

Contains a composite index to topics in the DN05 operating system manuals. 

Programmer’s Guides and Reference Manuals for Lan^ uages 

Each programmer’s guide describes one of the I anguages supported by DNOS (for example, assembly 
language, Pascal, COBOL). Each guide covers operating system information relevant to the use of that 
language in the DNOS environment. The details of the language itself, including language syntax and pro- 
gramming considerations, are in the languagie reforence manual. 

Link 'Editor Reference Manual 

Describes how to use the Link Editor on DNOS to (jombine separately generated object modules to form a 
single linked output. 

User’s Guides for Productivity Tools 

Each user’s guide describes one of the productivity tools (for example, TIFORM, Query-990, DBMS-990, 
Sort/Merge) supported by DNOS. Each guide expl alns the function of the processor, its features, and its 
interface requirements. 

User’s Guides and Programmer’s Guides for Communisations Software 

Describe the features, functions, and use of the communications software available for execution under 
DNOS. For example, there is a user’s guide for th a DNOS 3780/2780 Emulator software package. 

Supervisor Call (SVC) Reference Manual 

Presents detailed Information about each DNOS supervisor call and general information about DNOS 
services. 

Systems Programmer’s Guide 

Discusses the DNOS nucleus and subsystems at n conceptual and functional level and describes how to 
modify the system for a specific application environment. 

System Generation Reference Manual 

Contains the Information needed to perform system generation. Including pregeneration requirements, 
generation procedures, and Information about postgeneration results. 

System Design Document 

Contains the Information needed to understand the functioning of the system when using a source kit. This 
includes descriptions of the subsystems In deiail, naming and coding conventions, module cross- 
references, data structure details, and Informatlor not found in other manuals. 

SCI and Utilities Design Document 

Presents design Information about SCI and the DNOS utilities. 
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Preface 


This manual contains the information necessary for the assembly language applications pro- 
grammer to assemble, link, and execute programs under DNOS. The manual is designed as a pro- 
grammer’s guide rather than a reference manual so it does not focus on the assembly language 
instructions. Information in this manual relates to the assembling and executing of programs 
using the two-pass assembler, SDSMAC. 

This manual is organized into the following sections and appendixes: 

Section 

1 Introduction — Presents a brief overview of the steps involved in constructing, assem- 
bling, linking, installing, and executing an assembly language program. 

2 DNOS Concepts and Environments — Introduces the major concepts and features of 
the DNOS environment and familiarizes the user with the capabilities of the system. 

3 DNOS Assembly Language Program Concepts — Introduces mapping, program 
segmentation, task attributes, supervisor calls, and file and device services. 

4 Building an Assembly Language Program — Provides a brief description of the Text 
Editor and a sample of the use of the Text Editor commands and editing function keys. 
Helpful programming techniques are presented for the construction of a source code 
file. 

5 Assembling a Program — Describes the Execute Macro Assembler command and files 
generated during assembly. Examples of source listing, error message formats, cross- 
reference listing, and object code are presented. 

6 Linking and Installing a Program — Describes the linking operations performed by the 
Link Editor. Presents samples of linking and installing tasks, procedures, and overlays 
before execution. Sample link maps and a detailed description of the map contents is 
given for use in debugging. 

7 Executing a Program — Explains the three commands used to execute assembly 
language programs. 

8 Debugging a Program — Presents the debugging commands and samples of debugging 
techniques. 

9 Assembly Language Example — Presents a sample of assembling and executing an 
assembly language program. 



Preface 


Appendix 

A Abnormal Completion Messages — Lists the DNOS Abnormal Completion Messages 
mentioned in Section 5. , 

B Completion Messages — Lists the DNOS Completion Messages mentioned in Section 
5. 

C Listing Error Messages — Lists the DNOS Listing Error Messages mentioned in Section 
5. 


In addition to this manual, the DNOS software manuals shown on the support manual diagram 
(frontispiece) contain information related to DNOS SVCs. Further manuals containing useful 
DNOS and assembly language information are listed below: 

Title Part Number 

Model 990 Computer Microcode Development System 
Programmer’s Guide 2264445-9701 
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Introduction 


1.1 DNOS AND ASSEMBLY LANGUAGE 

The assembler supported by DNOS is the Model 990 Computer macro assembler (SDSMAC). 
SDSMAC supports the 990 computer instruction set as well as an extensive macro language 
capability. In addition to the macro capability, SDSMAC supports the following: 

• All instructions of the 990/10 and /12 instruction set with map option 

• Thirty-one assembler directives 

• Three pseudo-instructions 

• Use of parentheses in expressions 

• Logical operators in expressions 

• Relational operators in expressions 

• Many output options 

• Workspace pointer directive 

• Copy source file directive 

• Define operation directive 

• Transfer vector pseudo instruction 

• Common/Program/Data segment directives 


1.2 ENTERING PROGRAMS 

Assembly language programs may be prepared externally and entered into the system via a card 
reader or magnetic tape, or they may be prepared at a terminal using the Text Editor to create a 
file of source code. The compose mode of the Text Editor is used and the source code is entered 
on a line-by-line basis. Once all of the source code has been entered, the assembly language pro- 
gram is ready to assemble and execute. 

Assembly programs may use supervisor calls to perform I/O and program support functions. The 
supervisor calls are defined in the DNOS Supervisor Call (SVC) Reference Manual. 
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1.3 Introduction 


1.3 ASSEMBLING PROGRAMS 

Assembly language programs are assemibled by using the System Command Interpreter (SCI) 
Execute Macro Assembler (XMA) command procedure. The appropriate entries are made for each 
request. Once all the entries are made, the assembler is activated. When the assembly has com- 
pleted, a message appears stating that the assembly is complete. The number of errors or warn- 
ings encountered also appears. If errors are detected, the user should consult Appendix A or 
Appendix B, correct the errors, and reassemble the program. 


1.4 LINKING AND INSTALLING PROGRAMS 

A program must be linked if the assembled program issues references (REFs) to external pro- 
grams or modules. The Link Editor is defined in detail in the Link Editor Reference Manuai. 

The Link Editor is called by the Execute Link Editor (XLE) command. All modules and libraries to 
be linked are listed in the link edit control file. The user may also specify the output format. 

The output of the Link Editor exists in one of three formats, as defined by the user in the control 
stream. Two of the formats, normal tagged object and compressed object, are output to a sequen- 
tial file and must be installed in the system prior to execution. The third format, image, is installed 
by the Link Editor directly to a user specified program file. 

Assembly language programs are installed as procedures, tasks, or overlays by the various 
installation SCI commands or supervisor calls (SVCs). 


1.5 EXECUTING PROGRAMS 

Assembly language programs can be executed by the Execute Task (XT), the Execute and Halt 
Task (XHT), or Execute Task and Suspend SCI (XTS) commands, or the various SVCs. 


1.6 DEBUGGING PROGRAMS 

The debugging commands supported by DNOS aid the user in removing errors from (debugging) a 
program. The debug commands consist of two sets: controlled task commands and commands 
for all tasks. The controlled task commands operate on tasks in the debug mode. The other set of 
commands may be used on all tasks. Care must be taken in cases where tasks unconditionally 
suspend themselves, since some debug commands reactivate tasks. 


1.7 DNOS RESPONSE NOTATION 

Throughout the manual, the System Command Interpreter (SCI) commands are described and 
discussed for the purpose of aiding the user in the assembly and execution of programs. The legal 
response type, which may be entered for each particular prompt, is specified in each command 
description. These response types are listed and defined in Table 1-1. 
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Table 1-1. Response Type Indicators 


Response 

Type 

Definition 

Pathname 

I/O resource pathname. This type includes channel name, 
devicename, filename and stationname. The pathname may be 
specified by a synonym, synonym followed by a pathname 
(synonym. pathname), logical name, or logical name followed by a 
pathname (logical name, pathname). Legal characters in pathnames 
include uppercase alphabetic characters, numbers, $, [,], and back 
slash (\). On 911 VDTs, the back slash character is displayed by 
pressing the CONTROL and the equal ( = ) keys. The name must 
start with an alphabetic character. 

Devicename 

Name of a device (DS01, ST01, etc.). 

Filename 

File name may include disk name, the directory which contains the 
file, the file name within a directory, a logical name, or a logical 
name and file name (logical name. file name). 

Stationname 

Station ID (ST01, ST02, etc.). Users can find out the station ID by 
entering the Show Terminal Information (STI) command. 

YES/NO 

The response to a prompt may be YES, NO, Y, or N. 

Integer 

Hexadecimal or decimal number. Hexadecimal numbers must be 
preceded by entry of the > symbol or by entry of a leading zero. 

Integer exp 

Decimal or hexadecimal values or expression. Composed of 
decimal of hexadecimal integers and the operators + , - , *, and /. 

List 

List of decimal or hexadecimal values or expressions, separated by 
commas. 

Full exp 

Integer expression with the additional operators <, >, and ( ). String 
operands are also permitted. In debugger controlled mode, sym- 
bolic names and the symbols #PC, #WP, #ST, and #Rn are permit- 
ted. This type is unique to the SCI debugger. 

Full exp list 

A list of integer expressions separated by commas. 

Alphanumeric 

Alphabetic and/or numeric characters or a dollar sign ($), starting 
with an alphabetic character. (Used with user IDs, volume names, 
etc.) 

Character(s) 

Set of any characters. 
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1.7 Introduction 


To assist the user in determining the range of field prompt responses allowed by DNOS, the nota- 
tion convention shown in Table 1-2 is used throughout this manual. These notation symbols 
enclose some prompt responses in the command descriptions to define how DNOS expects the 
response type to be entered. 


Table 1-2. Field Prompt Notation 


Notation 

Meaning 

Uppercase 

Enter the response as listed. 

Lowercase 

Enter a response of this type. 

No marks 

The response is required. 

[ 1 

The response is optional. 

{ } 

The response must be exactly one of the enclosed 
items or must be a type of one of the enclosed 
items (choices separated by a slash). 

Item . . . item 

More than one item of this type may be entered to 
the response. Items should be separated by com- 
mas. 

@ 

Synonyms are allowed as responses. 

( ) 

Represents the initial value. If (*) is shown, the 
value may be supplied from a synonym set by a 
previously used command procedure. 


If a list is supplied in a form other than interactive- 
ly (batch mode or a command procedure calling a 
command procedure), the list must be enclosed in 
parentheses. 
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DNOS Concepts and Environment 


2.1 INTRODUCTION 

This section provides an overview of DNOS and describes some important system capabilities. 
Although some of these capabilities are not used in program development, they are included to 
familiarize you with the major system features and concepts. This section includes references to 
other documentation for more detailed discussion of some topics. 


2.2 JOB STRUCTURE 

DNOS uses a structure of jobs and tasks to perform the functions of a multitasking operating 
system. This job structure facilitates effective resource usage and subsystem isolation. 

A job is a coilection of cooperating tasks (programs) initiated by command procedures or from 
within an executing program. When you log on at a terminal, an interactive job begins. This job is 
associated with the terminal that started it. When you initiate a batch job, that job is not 
associated with any particular terminal. 

At each terminal, it is possible to have one foreground task and one background task concurrently 
active in the interactive job. Any number of jobs can be created as batch jobs. 

2.2.1 Interactive Jobs 

An interactive job can include tasks operating in the foreground, in the background, or both. A 
foreground task can accept data or commands from the terminal as the task operates. However, a 
background task, although initiated from the terminal, executes without interaction with the ter- 
minal until the task is finished. Consequently, you can start a task (for example, updating a data 
base) in background mode and perform other activities (such as data collection) in foreground 
mode while the background task is active. When complete, the background task returns a 
message to the terminal, indicating completion. 

Commands entered from interactive terminals are entered in foreground mode. The operating 
system responds by displaying the appropriate command prompts. Enter the required informa- 
tion; the task now begins execution. While the task executes in foreground, SCI is suspended to 
avoid interference. User interaction now occurs directly with the foreground task. The DNOS 
System Command Interpreter (SCI) Reference Manual describes the commands used to initiate 
tasks in all modes. 
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2.2.2 Batch Jobs 

Batch jobs use SCI to process batch commands, lip the batch mode, SCI accepts commands from 
any sequentially oriented device (typically a disk file of commands) but not from a terminal. Com- 
mands submitted in a batch command stream must include all parameters required for the opera- 
tion. Also, the commands included must be suitable for execution in the background mode. Com- 
mands that initiate operations requiring user interaction (for example, text editing and debugging 
commands) are not permitted. 


2.3 USING SCI 

The following paragraphs discuss the use of SCI. The DNOS System Command Interpreter (SCI) 
Reference Manual contains complete descriptions of SCI commands, plus procedures for 
creating new commands and menus. , 

2.3.1 SCI Description 

SCI is the interface between you and the operatingjsystem, system utilities, the software develop- 
ment programs, and application programs. Application programs can interface with you through 
user-defined SCI commands and menus. 

You can use SCI to activate programs and to passj parameters to the programs during execution. 

SCI also allows you to build and maintain tables ofjvariables, called synonyms and logical names, 

and their values. SCI allows application program^ to access these variables for use in the pro- M 

grams. 

To execute an application program via SCI, you caij^ use predefined execution commands such as 
Execute Task (XT), Execute COBOL Task (XCT), arid Execute Pascal Task (XPT) or you can write 
your own SCI command to initiate a program. You can add user-defined commands to the system 
library, or you can group them in a separate command library. The .USE primitive (described in the 
DNOS System Command Interpreter (SCI) Refereiice Manual) allows you to specify which com- 
mand library SCI should use. I 

You can enter SCI commands from interactive terminals or in batch command streams. In 
response to commands entered interactively, SCI d|lsplays command prompts associated with the 
command. i 

When all required prompts have been properly answered, SCI interprets the responses and 
initiates the requested operation. 

2.3.2 SCI Activation 

The following procedure shows the steps to activate SCI at video display terminals: 

1. Turn on the terminal if it is not already bn. 

2. Press the blank orange key. 

3. Press the ! (exclamation mark) key. 
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4. DNOS responds by displaying or printing the following message: 

DNOS XXXX 

where X.X.XX is the release version of DNOS. 

5. If user identification is required, DNOS displays the following two prompts: 

USER ID: PASSCODE: 

Type in the assigned user ID and press the RETURN key to signal DNOS that an entry 
has been made. Next, type in the assigned passcode and press the RETURN key to 
signal DNOS that an entry has been made. The characters of the passcode entered by 
the user are not displayed to preserve passcode security. 

6. DNOS may respond by displaying the following prompt (if it is not already displayed): 

JOB NAME: 

7. Type in a job name and press the RETURN key to signal DNOS that an entry has been 
made. A job name may be any alphanumeric string (maximum of eight characters) 
which starts with an alphabetic character or $ and consists of only uppercase 
characters. 

8. DNOS may respond by displaying the following prompt (if it is not already displayed): 

ACCOUNT ID: 

9. Type in the assigned account ID and press the RETURN key to signal that an entry has 
been made. 

10. DNOS may respond by displaying the following messages: 

SYNONYM FILE PATHNAME: 

LOGICAL NAME FILE PATHNAME: 

11. Type in the pathnames which contain the synonyms and logical names to be used, or 
press the RETURN key if the default pathnames are to be used. 

12. If the job name entered is already in use with the same user ID, DNOS may respond with 
the following prompt: 

RECONNECT?: 

13. Type in YES or NO and press the RETURN key to signal that an entry has been made. 
YES specifies that this terminal Is also to be associated with the job name in use. NO 
specifies that this terminal is to be associated with a new job. 
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14. If the log-on is successful, DNOS may respond with the SCI prompt ([ ]) or may display 
the news file if one exists. SCI then waits for the CMD key to be pressed. After the CMD 
key is pressed, SCI displays the default main menu and SCI prompt ([]) as shown in 
Figure 2-1. The default main menu may be changed at the option of the systems pro- 
grammer. Use the .MENU and .OPTION SCI primitives to specify the menu and prompt 
to be used. Refer to the DNOS System Command Interpreter (SCI) Reference Manual. 

15. Begin to operate the terminal by entering the SCI commands that are available as deter- 
mined by the privilege level associated with the user ID. If a command is entered that is 
not authorized for the user’s ID, SCI displays an appropriate error message. 

16. While executing SCI commands, the terminal should not be turned off. If the terminal is 
turned off, device errors are written to the system log and the system may loop in an at- 
tempt to complete the command. 


** TEXAS INSTRUMENTS ** 

** DNOSSYSTEM ** 


Command Groups: 


/DEBUG ~ 

/DEVICE - 

/DIR 

/EDIT 

/FILE 

/JOB 

/LANG 

/LUNO 

/MSG 

/NAME 

/PREXEC - 

/PFILE - 

/STATUS - 

/SYSMGT - 

/VOLUME - 


Interactive Debugger 

I/O Devices 

Directories 

Text Editor 

File Mbnagement 

Job Management 

Language Support 

Logical Unit Numbers 

Message Facilities 

Synonyms and Logical Names 

Program Execution 

Program Files 

Status Reoorts 

System Management 

Disk Volumes 


C3 


Figure 2-1. SCI Default Main Menu 
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2.3.3 Entry of SCI Commands in VDT Mode 

To enter an SCI command in VDT mode, type the characters (in uppercase letters) of the command 
and press the RETURN key. Upon entry of a command, SCI displays the full name of the command 
entered and all the field prompts associated with the command. Field prompts provide informa- 
tion and request parameters to complete command execution. For example, the following field 
prompt requests that you identify an output pathname: 

OUTPUT PATHNAME: 

2.3.4 Examples of Using SCI 

The following paragraphs contain examples of specific uses of SCI commands. Consult the 
DNOS System Command Interpreter (SCI) Reference Manual for a complete discussion of the SCI 
commands. 

2.3.4.1 The Show Background Status (SBS) Command. Use the SBS command to view the 
status of a program that is currently executing in background mode and that was initiated from 
your terminal. Since this command has no associated prompts, the command executes 
immediately after you enter SBS and press the RETURN key. A message indicating the state of 
the background activity appears, as follows: 

[]SBS 

SHOW BACKGROUND STATUS 
I STATUS-1217 TASK IS ACTIVE 

2.3.4.2 The List Directory (LD) Command. Use the List Directory command to list the names of 
all files and subdirectories in a directory. The display for this command is as follows: 

[]LD 

LIST DIRECTORY 

PATHNAME: pathname® 

LISTING ACCESS NAME: [pathname®] 

In response to the prompt PATHNAME, enter the pathname of the directory whose file names and 
subdirectory names will be listed. The ® indicates that the pathname can be specified by a 
synonym. 

In response to LISTING ACCESS NAME, enter the pathname of the device or file to which the 
listing should be written. The brackets ([ ]) indicate that the response is optional. The default value 
is the terminal at which the command is entered. A null response (pressing RETURN while the cur- 
sor is in a blank field) causes the default value to be accepted. In the following case, the directory 
SYS2.DP0080 is iisted to the terminal from which the command was executed. 
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11 LD 

LIST DIRECTORY 

PATHNAME; SVS2. DP0080 
LISTING ACCESS NAMb: 


DIRECTORY LISTING OF: SYS2. DP0080 

MAX # OF ENTRIES: 101 # OF ENTRIES AVAILABLE: 78 


DIRECTORY ALIAS OF 
ML * 

TIP * 


ENTRIES LAST UPDATE 
5 05/30/80 13:44:48 

11 05/07/80 12:02:20 


CREATION 

03/17/90 12:51:06 
02/11/80 16:44:21 


FILE 

ALIAS OF 

RECORDS 

LAST 

BATCH 

«■ 

24 

06/03/80 

COBOL 

« 

3550 

05/30/80 

DATA 


17 

05/07/80 


16: 21: 50 TUESDAY. JUN 03, 1980. 


UPDATE 

FMT 

TYPE 

BLK PROTECT 

08: 16: 56 

BS 

N SEQ 

YES 

14: 06: 46 

NBS 

N SEQ 

YES 

15: 31: 57 

BS 

N SEQ 

YES 


2.3.5 Batch Use of SCI 

To use SCI in a batch mode through batch streams, use the Execute Batch (XB) command; or 
through a batch job using the Execute Batch Job (XBJ) command. The XB command starts a 
background task that is associated with your terminal. XBJ starts a new job, not associated with a 
terminal. 

The following paragraphs discuss the characteristics of batch SCI and the differences in format 
between batch commands and commands entered interactively. 

2.3.5.1 Batch Stream Format. The first and last commands of a batch stream should be the 
BATCH and EBATCH commands, respectively. The BATCH command initiates the batch SCI 
environment. EBATCH indicates that the batch stream contains no more commands to be pro- 
cessed by SCI. 

Upon normal completion of the batch stream executing in background mode, the following 
message appears: 

BATCH SCI HAS COMPLETED 


2.3.5.2 Batch Command Format. When supplying SCI commands in batch stream format, 
include the following information for each command: 

• The characters of the command 
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All required prompts associated with the command 

The parameter values (responses) for the command prompts 
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The following demonstrates the Execute Link Editor (XLE) command in both interactive and batch 
form. (Refer to the Link Editor Reference Manuai for a compiete description of the XLE command.) 

Interactive Format. When you enter XLE interactively, the following prompts appear: 


[]XLE 



EXECUTE LINK EDITOR 

CONTROL ACCESS NAME: 

pathname® 

(*) 

LINKED OUTPUT ACCESS NAME: 

[pathname®] 

(*) 

LISTING ACCESS NAME: 

[pathname®] 

(*) 

PRINT WIDTH (CHARS): 

[integer] 

(80) 


To execute the command, respond to the CONTROL ACCESS NAME prompt by specifying the 
pathname of the file or device from which the control stream is to be read. Then, either specify 
values or accept the default values for the remaining prompts. If the control stream is contained 
in directory .M, file .CONTROL, the linked output is to be written to directory .M, file .OBJECT, the 
link editor iisting is to be written to directory .M, fiie .LIST, and an 80-character line is acceptabie, 
respond as foliows: 


[]XLE 


EXECUTE LINK EDITOR 

CONTROL ACCESS NAME 
LINKED OUTPUT ACCESS NAME 
LISTING ACCESS NAME 
PRINT WIDTH (CHARS) 


.M.CONTROL 

.M.OBJECT 

.M.LIST 

80 


Batch Format. To execute this command in a batch stream, inciude the characters of the com- 
mand, ali required and any optionai prompts that are specified, and the responses to those 
prompts. The following batch command is equivaient to the interactive version shown previousiy: 

XLE CONTROL = . M.CONTROL, LiNKED OUTPUT = .M.OBJECT, LiSTING = .M.LIST 

Notice that the default value for the PRINTWIDTH(CHARS) prompt is accepted by omitting it from 
the batch command. Also, you can use abbreviated versions of the specified command prompts. 
The abbreviation must be sufficient to uniqueiy identify the prompt. Often, only the first character 
of a command prompt need be entered. For exampie, the foliowing is equivalent to the previous 
example: 

XLE C = .M.CONTROL, LO = .M.OBJECT, LIST = .M.LIST 

A batch stream consists of one command or a series of commands in this format when preceded 
by the BATCH command and foliowed by the EBATCH command. The file containing the batch 
command stream is the input file for the XB and XBJ commands. Consult the DNOS System Com- 
mand interpreter (SCi) Reference Manuai for more information on batch command construction 
and batch capabilities. 
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2.3.5.3 Interactive Execution of Batch Streams and Batch Jobs. Use the XB command to 
execute batch streams as background activities from an interactive job. After you enter the XB 
command and the batch stream begins execution, you can continue to execute SCI commands in 
foreground mode. After the batch stream completes, the completion message appears the next 
time you press the CMD key. To monitor batch stream execution, you can enter the Show 
Background Status (SBS) command from time to time or use the WAIT command. Also, you can 
use the Show File (SF) command to view the iisting file for the batch stream during the run. 

An example of the XB command is as follows: 

[]XB 

EXECUTE BATCH 

INPUT ACCESS NAME: pathname® 

LISTING ACCESS NAME: pathname® 

The INPUT ACCESS NAME is the pathname from which DNOS should read the batch command 
stream. The LISTING ACCESS NAME is the pathname of the device or file to which DNOS should 
write the results of the batch stream execution. This device or fiie must not be used by any com- 
mand in the batch command stream. 


The XBJ command allows you to create the job stream commands and execute a batch SCI job 
independent of a terminal. Consequently, you can continue to execute SCI commands in 
foreground or background mode. A description of the XBJ command is as follows: 

[]XBJ 


EXECUTE BATCH JOB 

JOB NAME 
USE CURRENT USER ID? 
LOGICAL NAME TABLE PATHNAME 
SYNONYM TABLE PATHNAME: 


alphanumeric 

YES/NO 

[filename®] 

[filename®] 


(YES) 


The response to the JOB NAME prompt is a one-to-eight character, user-defined name for the job. 
If the response to the USE CURRENT USER ID? prompt is NO, a prompt for another user ID 
appears. (Some installations may require a passcode and/or account ID with the new user ID.) The 
LOGICAL NAME TABLE PATHNAME is a file containing the logical names to be passed to the 
new job. The logical name table is created using the Snapshot Name Definition (SND) command, 
described in the DNOS System Command Interpreter (SCI) Reference Manual. To pass the logical 
names of the creating job, enter a null response (the default). The SYNONYM TABLE PATHNAME 
is the file name containing the set of synonyms to be used by the new job. (The synonym table is 
also created using the SND command.) The synonym table must specify the Input Access Name 
and the Listing Access Name for the XBJ command. As in the XB command, the Input Access 
Name is the file that contains the batch commands, and the Listing Access Name specifies the 
file or device to which the results of the batch job should be written. If you enter a null response to 
the SYNONYM TABLE PATHNAME prompt, DNOS prompts for the INPUT ACCESS NAME and 
LISTING ACCESS NAME as in the XB command. The DNOS System Command Interpreter (SCI) 
Reference Manual contains further information on the XBJ command. 
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2.3.5.4 Entering Programs from Sequential Devices. You can use any sequential file of pro- 
gram source code for input to the compilers or assembler. If necessary, copy source code that has 
been key punched on a card deck to a sequential disk file. Program source code, entered by the 
Text Editor or Copy Concatenate (CC) command, can be read from devices. An example using the 
CC command to copy the source code from cards to a disk file Is as follows: 

[]CC 

COPY/CONCATENATE 

INPUT ACCESS NAME(S): CR01 
OUTPUT ACCESS NAME: .USER.SOURCE 
REPLACE?: NO 
MAXIMUM RECORD LENGTH: 


2.4 DIRECTORY AND FILE STRUCTURE 

DNOS file management allows you to build, organize, and access directories and files. A file con- 
sists of a named collection of data. The data in the file can be generated by you (for example, 
source code or documentation) or by the system (for example, object code or listing files). A direc- 
tory is a relative record file that contains the information necessary to locate other files and 
describes the characteristics of those files. It does not contain user data. 

^ 2.4.1 Establishing Volume Names 

Volume names are alphanumeric character strings of as many as eight characters that identify 
the disk on which a file is found. The first character of a volume name must be an alphabetic 
character. For example, VOL1 could be the volume name of a disk. 

The Initialize Disk Surface (IDS) command prepares the disk surface for initialization by the 
Initialize New Volume (INV) command. The IDS command must be performed prior to the first INV 
command. It is not necessary to perform another IDS before any further initializations of the disk. 

The INV command assigns volume names to disks. Once a volume is initialized by an INV com- 
mand, all access to files on that volume must include the volume name in the pathname or access 
name, unless the volume is the system disk or unless a device is specified. 

One disk drive on each system (usually DS01) is designated to hold the system disk. The system 
disk contains all required operating system components, including the loader program, system 
program files, and temporary system files. The system disk is the default volume when no volume 
name is specified. For example, .PROOF designates a file named PROOF on the system disk. 

2.4.2 Establishing Directories 

Each disk volume has a file directory named VCATALOG, where DNOS maintains a volume table 
of contents. The files described in VCATALOG are data files or directory files (Figure 2-2). 

DNOS directories contain the names of and pointers to other files. Directories do not contain user 
data. Typically, related files are contained in a directory. Directories can also contain subdirec- 
tories. Both directories and subdirectories are created by the Create Directory File (CFDIR) com- 
^ mand. A subdirectory can be created under a directory only after the directory has been created. 
For example, subdirectory VOL1.SOURCE.PROGRAMA can not be created unless directory 
VOL1 .SOURCE already exists. 
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Figure 2-2. Directory and File Structure 


It is convenient to group related files into a single directory. For example, all source files for a pro- 
gram might be in a directory named VOL1.SOURCE.PROGRAMA; all listings generated from 
assembly or compilation of source moduies for this program might be in a directory named 
VOL1. LISTING. PROG RAMA. (Refer to Section 3 for more information on alternative ways to struc- 
ture files for programs.) 

Do not assign file names that might be confused with DNOS system file names. Most system file 
or directory names begin with S$. 
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2.4.3 Establishing Files 

After initializing a disk volume and creating directories and subdirectories, you can create files 
that are accessible either under the volume or under a directory or subdirectory. The following 
commands are available to create files: 

• Create Key Indexed File (CFKEY) 

• Create Relative Record File (CFREL) 

• Create Sequential File (CFSEQ) 

• Create Program File (CFPRO) 

• Create Image File (CFIMG) 

• Create File (CF) 

The CF command requires the subsequent selection of a file type. These commands are 
described in detail in the DNOS System Command Interpreter (SCI) Reference Manual. 


2.5 PATHNAMES AND ACCESS NAMES 

A file on a disk volume is referenced by its pathname. A pathname is a concatenation of the 
volume name, names of the directory levels leading to the file (excluding VCATALOG), and the file 
name itself. Each component of a pathname cannot exceed eight characters in length. A com- 
plete pathname must not exceed 48 characters including periods. The components of the 
pathname are separated by periods, as in the following examples: 

VOL1 .AGENCY.RECORDS 

MYDIRECT.MYDIRCTA.MYFILE 

VOLTWO.DEB 

EMPLOY01.USRA.PAYROLL 

EMPLOY01.USRB.CATALOGX.PAYROLL 

An access name may be a device name, volume name or file pathname. For device names, you 
must use certain default names (except for special devices). Example device names include ST02 
for terminal number 2, LP01 for line printer number 1, and DS03 for disk number 3. 
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You can reference a volume on which a file resides through either the device name or the volume 
name. Omitting the volume name and beginning the pathname with a period indicates that the file 
is on the system disk. Samples of valid names for devices and files are as follows: 


File Identifier 


Meaning 


CR01 

DS02.MYCAT.MYFILE 

.MYCAT.MYFILE 

VOLID.MYCAT.MYFILE 


Device name 

Device name, directory name, file name 
System disk, directory name, file name 
Volume name, directory name, file name 


2.6 SYNONYMS AND LOGICAL NAMES 

DNOS supports use of synonyms and logical names for I/O resources. Synonyms are used to 
abbreviate long text strings. Logical names are used to abbreviate resource names, define 
resource access, and pass parameters associated with the resource (devices, files, or channels). 

2.6.1 Synonyms 

Synonyms are abbreviations of one or more characters in length that are commonly used in place 
of long pathnames or portions of pathnames. These synonyms are always available to foreground 
tasks. Background tasks receive a copy of the foreground synonyms when the background task is 
initiated. At terminals requiring log-on, user-defined synonyms are associated with that user’s ID 
and are available whenever the user logs on at any terminal. Use the Assign Synonym (AS) and 
Modify Synonym (MS) commands to define synonyms and to modify defined synonyms. When you 
enter a synonym in response to an SCI command prompt, the synonym Is replaced by the actual 
text string. 

When an SCI command is executed in foreground mode, you can use a synonym only as the first 
or only component of a pathname (device name or file name). For example, if A is a synonym for 
directory VOLI. SOURCE and B is a synonym for PROGRAMA in that directory, A.PROGRAMA is 
an acceptable file name. However, VOLI .SOURCE.B or A.B are not acceptable. Refer to the DNOS 
System Command Interpreter (SCI) Reference Manual for use of synonyms in batch streams in the 
background mode. 

2.6.2 Logical Names 

A logical name is a user-specified, alphanumeric string of up to eight characters. Programs use 
logical names to access I/O resources. An I/O resource can be a device, an IPC channel, a file, or a 
set of concatenated files. You have the option of assigning a LUNO to a logical name that maps to 
an access name. (A LUNO is a logical unit number that represents a file or device; see paragraph 
2.8.4.) 

Since each logical name is associated with a set of parameters (the set assigned to the cor- 
responding I/O resource), logical names provide a means of passing the parameters assigned to a 
given resource. Use the Assign Logical Name (ALN) command to specify values for these 
parameters. The DNOS System Command Interpreter (SCI) Reference Manual contains a detailed 
description of this command. 
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Some examples of the types of parameters associated with logical names are as follows: 

• File characteristics 

• Access privileges 

• Spooler Information 

• File creation 

• Auto-generate pathname 

• Job temporary files 


2.7 FILE TYPES 

DNOS supports the following file types: sequential, relative record, and key indexed. 

2.7.1 Sequential Files 

Sequential files are variable-record-length files whose records are always read, written, and 
accessed serially (that is, record 0 must be accessed first, record 1 must be accessed next, and so 
on). Some examples of using sequential files are as follows: 

• As an input file for card images. If a logical record length of 80 is specified, the sequen- 
tial file can be treated as a card reader by the program reading the file. 

• As an output file. In this function, the file can resemble the line printer. 

• As a location for listing files from DNOS processors. 

2.7.2 Relative Record Files 

Relative record files are also called random access files. Unlike sequential files, relative record 
files may be accessed in any order. Each record has a unique record number, which you specify to 
access that individual record. The operating system increments the caller’s record number after 
each read or write so that sequential access is permitted. One end-of-file (EOF) record is main- 
tained wherever it was last specified by a program. The range of record numbers is from 0 to one 
less than the number of records in the file. The maximum number of records in a relative record 
file is 2 to the 24th power. The records are fixed In length, and the length must be specified during 
file creation. 

Relative record files are useful when each record in the file is already associated with a unique 
value ranging from 0 to n; for example, in an inventory file, the item number can be specified as 
the record number. Consequently, information about item number i can be obtained by accessing 
record number i. 
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Special types of relative record files available in DNOS are directory, program, and image files. 
These files provide special interface mechanisms that are used primarily for memory images, 
memory swapping, and diagnostic dumps. 

• Directory Files — Contain names of and pointers to other files 

• Program Files — Contain program images and an internal directory of the images 

• Image Files — Special-purpose files used primarily by the operating system for memory 
images, memory swapping, and diagnostic dumps. 

2.7.3 Key Indexed Files 

A key indexed file (KIF) allows random access to Its records via a key. The key is a character string 
of up to 100 characters, located in a fixed position within each file record. From 1 to 14 individual 
keys may be specified. For example, the records in an employee file might be accessed by keys 
that indicate the employee’s id, name, and social security number. 

Keys can overlap one another, with certain restrictions, within the record. Although the keys can 
be structured anywhere within a record, they must appear in the same relative position in all 
records in the file. One key must be specified as the primary key; the other keys are secondary 
keys. The primary key must be present in all records, but secondary keys are optional. 

In addition to supporting random access, KIFs include the following characteristics: 

• Records can be accessed sequentially in the sort order of any key. 

• At file creation, any key can be designated as allowing duplicates, which means that 
two or more records in the file can have the same value for this key. 

• At file creation, any key except the primary key can be designed as being modifiable. 
This means that when a record is being rewritten, the key value may change. Also, a 
secondary key value that is missing in the record can be added later on a rewrite. 

• Keys can overlap. 

• Records can be of variable length and can change in size on a rewrite. 

• Searching on partial keys is allowed. 

• Records are automatically blank suppressed. 

• Record-level locking is supported. 

• The size of the file can increase. 

• File integrity is maintained through pre-image logging of modified blocks. Before a 
record is modified on disk, it is copied to a backup area in the file overhead area. Conse- 
quently, system failures cause the loss of only the last I/O operation. 

• Records of odd or zero length are not allowed. 
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2.7.4 Concatenated and Multifile Sets 

Sequential and relative record files can be logically concatenated by setting the values of a 
logical name to the pathnames of a set of files. Logical concatenation allows access to the files, 
in sequence, without requiring that they be physically concatenated. (When required, physical 
concatenation can be performed by the Copy/Concatenate SCI command.) A multifile set is a set 
of key indexed files, the pathnames of which are the values of a logical name. The files in the set 
are associated in a nonreversible manner. Individual components of concatenated and multifile 
sets can be on separate disks. 

Several restrictions apply to the concatenation of files. The files must be of the same type and 
may not be special use files such as directories, program files, key indexed files, or image files. 
Relative record files to be concatenated must have the same logical record size. A concatenation 
cannot contain both blocked and unblocked records, and any LUNO assigned to a file must be 
released before concatenating the file. 

The following special rules apply to combining key indexed files in a multifile set; 

• At the first definition of the multifile set, all but the first file must be empty. 

• None of the files can be a member of an existing multifile set. 

• All of the files must have the same physical record size. 

• The files must have the same key definitions. In subsequent definitions of these sets, 
the same files must be associated in the same order, and none of the original set can be 
omitted. One empty file can be added at the end (but not at any other position). 

• You cannot use key indexed file operations to individually access key indexed files of a 
multifile set. You can access these files only by using operations that examine physical 
records or absolute disk addresses. 

The multifile set of key indexed files permits a larger key indexed file than one disk can store. 
When a key indexed file can no longer expand because there is insufficient space on the disk, you 
can create a new file on another disk. By using a logical name, the two files can be used as one. 
The second file is used as an extension of the first. For example, assume the first file contains 
5000 physical records. When physical record 5001 is required, the first physical record of the sec- 
ond file, record 0, is used. 

Only a few of the file utility operations of the I/O Operations SVC apply to concatenated and 
multivolume sets. They are as follows: 


Code 

Operation 

91 

Assign LUNO 

93 

Release LUNO 

99 

Verify Pathname 


Tne Assign Logical Name (ALN) SCI command associates files collectively with a logical name. 
Actual logical concatenation or creation of a multifile set occurs when a LUNO is assigned to the 
logical name. You can access a concatenated file only for the duration of the logical name. You 
must specify the files in the concatenation order desired. You can specify by pathname, synonym. 
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logical name, or a logical name and pathname combination. However, all forms must resolve to 
valid pathnames. All files in the concatenation or multifile set must be precreated and online 
when the logical name is used. 

The last file in a concatenation set can be expandable. All other files become nonexpendable 
until the logical name is released or the job terminates. 

When a single end-of-file (EOF) mark appears at the end-of-medium (EOM), the end-of-file Is masked. 
This allows concatenated files to be accessed logically as a single file without the return of in- 
termediate end-of-file marks. Note that any intermediate end-of-file mark not at the end-of- 
medium is always returned. If two end-of-file marks are encountered at the end-of-medium, a 
single end-of-file is returned. 

Several users can access the same concatenated or multifile set if the access privileges permit. 
Two concatenated files are Identical when they consist of the same pathnames in the same order. 
To maintain file integrity, an error is returned if any of the precreated files of a concatenated file 
are being accessed Independently. A concatenated file is deleted by deleting the individual files. 


2.8 I/O FACILITIES 

I/O resource management in DNOS allows a program to request resources dynamically during 
execution. When a resource is requested but is not available, the program or the user is notified 
immediately. The request for resources is not queued and the program is not suspended. This 
allows the program to either abort or retry the request, thereby avoiding a deadlock situation. 

I/O resources are allocated to programs according to access privileges that the program requests 
when issuing an open operation. If the requested privilege is compatible with previously granted 
requests, the open completes without error. The program is then guaranteed the type of access 
requested (exclusive, exclusive write, shared, or read only). 

2.8.1 I/O Methods 

DNOS supports I/O operations to various types of devices, files, and IPC channels, all of which are 
referred to as I/O resources. DNOS also supports communication between programs using IPC 
channels. 

Two methods of I/O are available; resource-specific and resource-independent. Resource-specific 
I/O uses special features of one particular device or file. Resource-independent I/O allows the 
user to specify I/O for any of several devices without concern for special features. Both types of 
I/O allow a program to interact with predefined devices, files, and channels. The interaction 
occurs through the use of LUNOs. 

2.8.1. 1 Resource-Specific I/O. Resource-specific I/O operations assume device, channel, or 
file peculiarities. For example, activating the graphic capability on the 911 VDT is a resource- 
specific I/O operation. Other such operations include the following: 

• Extended VDT operations 

• Create/delete files and other file-specific I/O utility operations 

• Direct disk I/O 
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• Random access operations to key indexed and relative record files 

• IPC master-slave channel owner operations 

2.8.1. 2 Resource-Independent I/O. When resource-independent I/O is used, application pro- 
grams do not distinguish between devices, files, and channels. Also, a program can read and 
write data records independently of the type of device or file used. Examples of such types of 
operations include read, write, forward space, and write EOF. All devices, files (including KIF), 
and channels support resource-independent access. 

2.8.2 Interprocess Communication 

Interprocess communication (IPC) enables two or more tasks to exchange information via com- 
munication channels. IPC channels are created by the Create IPC Channel (CIC) command, or the 
Create IPC Channel I/O SVC. In each channel, one task must be designated as the owner of the 
channel. The channel owner task controls use of the channel. Requester tasks (slaves) have less 
flexibility and fewer privileges. 

2.8.2.1 IPC Uses. IPC is used for four primary reasons: 

• Synchronization — Tasks may synchronize activities by passing messages via IPC. 

• Queue serving — A channel owner may serve a queue of requests from other tasks. 

• Interception — Channel owner tasks receive requests from queues. Interpret or modify 
the information, and pass the changed data to another task or device. 

• Messages — Any variety of uses determined by the programs involved. 

2.8.2.2 IPC Channels. An IPC channel is a logical path used for communications between two 
tasks. Two types of IPC channels are available in DNOS: master/slave channels and symmetric 
channels. For a master/slave channel, the owner of the channel (the master) interprets and/or 
executes messages transmitted on the channel by requesters (slaves). Special commands must 
be used by the owner to appropriately read and write the messages. For a symmetric channel, the 
owner and requestor(s) issue simple Read and Write commands. These commands must match 
each other. The Read command of one task is processed as soon as the other task issues a Write 
command and vice versa. 

2.8.2.3 Channel Scope. The scope of a channel governs access to various jobs and tasks. The 
scope is determined by the channei type: global, job-local, or task-local. 

• Global Channel — Not replicated (only one exists in the whole system) and accessible 
by any task in the system. The channel must first be used by the owner task. The owner 
task cannot be automatically bid (made ready for execution) by an AL command. Multi- 
ple tasks can concurrently use a global channel that permits shared access. 

• Job-Local Channel — Replicated once for each job and accessibie by any task in the 
job. The channel can be shared and the owner task may be automatically bid by an AL 
command. 

• Task-Local Channel — Replicated once for each requester task (many per job) in any 
job. The channel cannot be shared, and the owner must be automatically bid by an AL 
command from a requester task. 
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2.8.2.4 System-Level IPC Functions. SCI commands are available to perform the following 
system-level IPC functions: 

• Create IPC Channel (CIC) 

• Delete IPC Channel (DIC) 

• Assign LUNO (AL) 

• Release LUNO (RL) 

• Show Channel Status (SCS) 

2.8.2.5 Program-Level IPC Functions. All program-level access to IPC occurs through the use 
of SVCs. Operations used by a master/slave channel owner are special I/O SVCs; operations used 
by requesters and by symmetric channel owners are standard I/O SVCs. In general, owner tasks 
get information from the channels and return an owner-determined response. However, requester 
tasks use IPC SVCs in a transparent manner; the effect of each call depends on the owner task. 
Refer to the DNOS Supervisor Call (SVC) Reference Manual for more details about channel opera- 
tions. 

2.8.3 File I/O 

DNOS provides disk file I/O support for application and system programs. Disk file I/O is per- 
formed through the same SVC mechanism used to perform I/O to devices. Assembly language 
programs must directly incorporate the SVC mechanism to perform I/O. 

2.8.4 Device I/O 

A device may be specified by either a device name or by a logical name. All standard DNOS I/O is 
performed to LUNOs rather than to physical resources. A LUNO, specified in an I/O operation, is a 
hexidecimai number that represents a file, channel, or device. DNOS maintains a list of LUNOs 
that indicate corresponding physical devices. LUNOs can be assigned by the AL command, or by 
use of an Assign LUNO SVC, and can have one of three scopes as follows: 

• Global LUNOs are defined (and are available) for all tasks and jobs. 

• Job-local LUNOs are defined (and are availabie) for all tasks in a job. 

• Task-iocal LUNOs are defined only for the task that assigns them. 

2.8.5 Spooling 

The spooling of data can occur during job execution as output is generated by one or more tasks. 
Spooling is the process of receiving data destined for a particular device (or type of device) and 
writing that data to a temporary file (or files). The spooler subsystem schedules the printing of job- 
local and permanent files among available printing devices. You can implement spooling in two 
ways, either by the PF command, or by sending output to a logical name. 

If you use the PF command, specify the following options: 

• Banner Sheet — A cover sheet containing the job name, user ID, time, and date. 

• Forms — A particular form for printing devices. 
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• Device Class Type — Any of a class of devices (class name definition). For example, 
you can specify any line printer, or any printer that prints uppercase/lowercase, without 
naming a specific printer. 

• Format Selection — Either FORTRAN control characters (blank, 0, 1, or + in column 
one) or ASCII control characters. 

• Multiple Copies — Multiple copies for a file or files. 

• Priority — Files for printing based on an assigned priority. 

To use a logical name , you must assign the logical name, using the ALN command, and specify 
the options (which are the same as those for the PF command.) You can use the logical name in 
programs and utility commands, such as SCI, In either batch or interactive mode. 

As an example, let’s assume you have assigned the logical name OUT and specified the following 
options: 

• LP02 

• standard format 

• 2 copies 

Each time you send a file or listing to OUT, the spooler schedules two copies of OUT to print on 
LP02 in standard format. You can design strategies according to your specific needs. 


2.9 SEGMENTS 

A task in DNOS consists of various program sections, each of which has certain features (at- 
tributes). The attributes of some sections may be different from others. A program section is called 
a segment. A task in DNOS can consist of up to three “segments.” The number of segments in 
a task depends in part on the attributes that can be assigned to the various sections of the pro- 
gram. In general, if all sections of a program have the same attributes, only one segment is need- 
ed; if a division of the program is made into sections with differing attributes, multiple segments 
may be needed. 

The user can build the program, specifies appropriate division of the program to the Link Editor, 
and installs the segments on a program file. The actual movement of segments into memory dur- 
ing execution varies, depending on whether or not the program explicitly requests certain 
segments. In most cases, DNOS handles segment changes without user action required. 

To install a task, specify an initial set of segments (up to three) and the desired mode of access to 
those segments. To execute a task from an executing program, load the initial segment set (if 
necessary) and grant the desired access. Use the appropriate SCI command to execute a task 
from SCI. 
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2.10 MESSAGE FACILITIES 


The DNOS Messages and Codes Reference Manual describes all system codes and messages in 
detail and should be consulted if the system displays only the error code. For systems that have 
the full message displayed, the paragraphs that follow discuss the components of termination 
messages and two methods of showing expanded error messages. Later sections discuss the use 
of condition codes and messages in application programs. The DNOS Systems Programmer’s 
Guide gives instructions for creating and modifying messages. 

2.10.1 Error Messages 

When an error occurs, SCI displays the message on the bottom line of the terminal screen and 
inhibits further operation until you acknowledge the message by pressing the CMD key or the 
RETURN key. Errors may be generated within SCI during SCI command execution or by any utility 
activated by an SCI command. 

The error messages consist of three parts: the error source indicator, a unique identifier, and the 
message. The error source indicators are as follows: 


Indicator 


Meaning 


I Informative message 

W Warning message 

U User error message 

S System error message 

H Hardware error 

US User or system error 

UH User or hardware error 

SH System or hardware error 

UHS User, hardware, or system 

The unique identifier is a code containing the category of the message (such as SVC, Pascal, or 
utility). This code may be followed by an identifier for a specific message within that category. 


For example, if you attempt to access a nonexistent file, the following error message appears: 
U SVC-0315 filename DOES NOT EXIST (SF; 5) 


where filename is the name of the file you tried to access. If you need additional information 
about an error, use on-line expanded error messages or refer to the DNOS Messages and Codes 
Reference Manual. 

2.10.2 On-Line Expanded Error Message Documentation 

If your system supports expanded message information on-line, both the Show Expanded 
Message (SEM) command and the ? response to the error messages are available. 
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2.10.2.1 Show Expanded Message (SEM) Command. Use the SEM command to display an 
expanded description of a termination code. Enter SEM to activate the procedure. You are promp- 
ted to specify the type of error (such as SVC or SCI) and the message identifier. These appear in 
the second field of the termination message. An example of the SEM command display is as 
follows: 

[]SEM 

SHOW EXPANDED MESSAGE 

MESSAGE CATEGORY: SVC 
MESSAGE ID: 0315 

The following information appears on the terminal: 

Explanation 

The specified file or channel does not exist. 

Action 

If the file or channel pathname is specified as intended, create the file or channel and retry 
the operation. Otherwise, retry the operation specifying the intended pathname. 

2.10.2.2 The ? Response. If you enter a question mark (?) immediately after receiving an error 
message, SCI uses the error category and message ID to display the expanded description of the 
error. SCI displays the original message and the same information as the SEM command. 

2.10.3 Status Messages 

Several SCI commands display status messages to inform you of the actions being taken during 
command execution. These messages appear on the bottom line of the terminal screen. 
Acknowledge the message by pressing the CMD key or RETURN key so that operation can con- 
tinue. Expanded status messages can be secured in the same way as error messages. 
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3.1 INTRODUCTION 

A program is a collection of machine instructions and data that direct the activities of the com- 
puter to perform a particular function. A program that executes under DNOS is called a task. 
There may be several activations of the same program at a given time but each activation is a dif- 
ferent task. For example, the System Command Interpreter (SCI) is a program and each station 
may have, as a task, a unique activation of the SCI program. A program becomes a task when 
DNOS assigns a runtime ID. Multiple copies of a task may share common procedure or data 
segments. 


3.2 PROGRAM MAPPING 

The 990/10 and 990/12 computer hardware has a 20-bit memory address bus and can address 
1024K words of memory. The logical address space available to a task is limited, by a 16-bit byte 
address, to 64K bytes. This difference is resolved by DNOS mapping the logical address space of 
the task into the physical address space of the computer. As shown in Figure 3-1, the mapping 
hardware can map one, two, or three segments of logical address space into one, two, or three 
segments of physical address space. 


PHYSICAL ADDRESS 
SPACE 


64K 

MAXIMUM 


2279939 


LOGICAL ADDRESS 
SPACE 



Figure 3-1. Mapping 
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The segments in physical address space need not be contiguous. Since DNOS maintains 
separate mapping parameters for each task, each task may consist of one, two, or three segments 
with a total size of 64K bytes. A program includes one unique segment called a task segment. The 
task segment must contain the workspace address, the entry point, and the end action entry 
point. A program may also contain sharable segments called procedures. Figure 3-2 illustrates 
two tasks sharing two segments of memory. The two tasks could be, but need not be, instances of 
the same program. For example, both tasks might be instances of the SCI program executing at 
different stations. 

The 990 computer instructions which control mapping are privileged. (Use of these instructions by 
nonprivileged user tasks causes task termination.) DNOS memory management controls mapping 
so that the mapping function is transparent to user tasks. 
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Figure 3-2. Tasks Sharing Segments 
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3.3 PROGRAM SEGMENTATION AND PROCEDURAL STEPS 

Mapping allows users to segment programs as: 

• Single segments, including both data and executable code. When installed on a pro- 
gram file, these segments are called task segments, and each instance of the program 
in execution is called a task. 

• Two separately loadable segments consisting of a procedure segment and a task seg- 
ment. 

• Three separate segments, consisting of two procedure segments and a task segment. 

Since DNOS manages memory in 32-byte blocks, the following boundary rules apply for programs 
consisting of two or three separate segments: 

• The first procedure segment (if any) begins at address 0 in the logical address space 
seen by the executing program. 

• The second procedure segment (if any) begins on the first 32-byte boundary immedi- 
ately following the first procedure in the logical address space seen by the executing 
program. 

• The task segment begins on the 32-byte boundary immediately following the last pro- 
cedure in the logical address space seen by the executing program. 

These memory boundary requirements are supported by the Link Editor, as defined in the Link 
Editor Reference Manuai. 

Figure 3-3 illustrates the possible memory configurations for programs under DNOS. The follow- 
ing paragraphs outline the processes for achieving any of these configurations. The maximum 
allowable memory for each task in any configuration is 64K bytes. 

3.3.1 Single Task Segment 

Part A of Figure 3-3 iilustrates a program consisting of a task segment. The following process 
generates this configuration: 

1. The source program is assembled (perhaps in several modules). 

2. If more than one object module is involved, the object code is linked into one module by 
the Link Editor. 

3. The linked object module is installed on a program file as a task segment using the 
Install Task (IT) command, or as a function of the Link Editor FORMAT IMAGE command. 

4. The installed task is executed using an SCI command or SVC operation. 
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Figure 3-3. Task Memory Configurations 


3.3.2 Task Segment and One or Two Procedures 

Parts B and C of Figure 3-3 illustrate a program with a task segment and procedure segment(s). 
The following process generates this configuration. 

1. The various modules of the program are separately assembled. 

2. The two (or three) segments of the program are linked by the Link Editor. To be separ- 
ately loadable, the procedures must be specified by the PROCEDURE command to the 
Link Editor. The task must be specified with a TASK or PHASE 0 command. 
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3. The procedure(s) is installed using the Install Procedure (IP) command or by the Link 
Editor FORMAT IMAGE command. 

4. The task segment is installed using the IT command with the ATTACHED PRO- 
CEDURES? option selected. The procedure IDs specified during the IP command are 
entered in response to the prompts of the ATTACHED PROCEDURES? option prompts. 

5. The installed task is executed using an SCI command or SVC operation. 


3.4 SUPERVISOR CALLS 

The interface between application programs and DNOS is the supervisor call (SVC). In programs 
written in a high level language, most supervisor calls are provided in the run-time package for the 
language and are transparent to the user. However, the high level language programmer may 
write SVCs to perform functions not otherwise available. The assembly language programmer 
must code all supervisor calls. 

Supervisor calls are implemented as an extended operation (XOP) in DNOS. Specifically, XOP 15 
is the means of entry to the SVC processor of DNOS. The address supplied with the XOP instruc- 
tion is that of the user’s supervisor call block. The following is an example of the code for a SVC: 

XOP @SCB,15 EXECUTE SVC DEFINED IN BLOCK SCB 

The assembly language includes a directive that provides a convenient and meaningful substitute 
for the XOP command. The DXOP directive defines a symbolic operation code for an XOP. The 
following example defines SVC as XOP 15: 

DXOP SVC,15 DEFINES SVC AS XOP 15 

When you include the DXOP at the beginning of your program, you may code an SVC as follows: 

SVC @SCB EXECUTE SVC DEFINED IN BLOCK SCB 


3.5 THE SUPERVISOR CALL BLOCK 

The DNOS supervisor call block is the data structure that defines the supervisor call. The 
statements described in the preceding paragraph apply to all DNOS supervisor calls. The dif- 
ference between SVCs is the content and format of the supervisor call block. 

A supervisor call block consists of at least one byte, and as many additional bytes as the SVC 
requires. The first byte (and only byte for some SVCs) contains the opcode that defines the SVC. 
Opcodes >00 through >7F are reserved for SVCs supported by DNOS. The user may define SVCs 
for applications in the range of >80 through >FF. Creation of user-defined SVCs is described in 
the DNOS Systems Programmer’s Guide. 

The second byte of many SVCs is the return code byte. DNOS returns a satisfactory completion 
code (zero in most cases) in this byte when the operation completes successfully. DNOS returns 
an error code in this byte when the operation completes in error. 
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Some of the DNOS SVCs provide several different operations as determined by a sub-opcode in 
the third byte of the supervisor call block. In these cases, the actual operation to be performed is 
selected by the opcode and the sub-opcode. 

Some of the bytes in the supervisor call blocks of some SVCs contain the result of the requested 
operation after the operation has completed. That is, the system returns values in some fields of 
some supervisor call blocks. 

The additional bytes of the call blocks of SVCs may contain various types of information related 
to the operation which are provided by the user: 

• Flags 

• Input or output data 

• Addresses of input or output data 

• Size or count values 

• Identifiers 

• Task parameters 

• LUNOs 

• Character strings 

The specific supervisor call block for each SVC is described in the DNOS Supervisor Call (SVC) 
Reference Manual. 


3.6 ENTRY VECTOR 


DNOS transfers control to a task via an entry vector in the task segment. The first three words of 
the task segment must consist of the following vector: 


First Word: 
Second Word; 
Third Word: 


Initial workspace address (WP). 
Initial entry point address (PC). 
End action entry point address. 


For example: 


WSPACE 


IDT TASK’ 

REF PROC1, ERPROC 
DATA WSPACE 
DATA PROC1 
DATA ERPROC 
BSS 32 WORKSPACE 


Task Data 


END 
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If the end action entry point address is zero, DNOS terminates the task when a fatal error is 
detected. If the address is not zero, control is transferred to the specified address whenever a 
fatal task error occurs. If no end action routine exists or when the end action routine executes an 
End Task SVC, DNOS releases resources from the task and takes it out of execution. 


3.7 SHARING PROCEDURE SEGMENTS 

A program may have one or two procedure segment(s) which contain code or data to be shared 
with a second activation of the program or with a different program. In the case where two or more 
tasks using the procedure segment are active concurrently, the procedure segment must be reen- 
trant to be sharable (refer to the paragraph on reentrant programming for more information). If 
there will never be two or more tasks active at the same time using the procedure segment, the 
procedure segment may contain modifiable code or data storage and still be sharable. 

To be reentrant, a procedure segment must not contain any data storage that is modified during 
execution, including a workspace. Also, all tasks that include a shared procedure segment must 
be linked so that any memory addresses in the task segment that are referenced by the procedure 
segment contain the same code or data storage in each individual task segment. 

Refer to section on linking and the Link Editor Reference Manual for command descriptions and 
further linking information. 


3.8 REENTRANT PROGRAMMING 

A procedure is called reentrant if it may be shared by several users at the same time without loss 
of data. A procedure is called pure if it contains only unmodifiable code and constant data; it is, 
effectively, read only. Pure procedures are reentrant. Moreover, every program may be split into a 
pure part containing only executable code and another part containing data and code which is 
modified at run time. 

DNOS supports shared pure procedures. (Nonreentrant procedures may be shared, but DNOS 
does not guarantee data integrity.) Further, the 990 language processors and the 990 Link Editor 
support a special construction which simplifies reentrant coding. That is, if an assembly 
language program uses the Program Segment (PSEG) directive to denote executable code, the 
Common Segment (CSEG) directive to denote common data, and the Data Segment (DSEG) direc- 
tive to denote locally used data for modules included in a procedure, the Link Editor separates the 
program accordingly: 

• Executable code into the procedure segment 

• Data into the task segment 

• Common data into the task segment 

If the PROCEDURE directive is used during link edit, the procedure segment created during link- 
ing contains no DSEGs. If all the volatile storage is in DSEGs, then the procedure will be reentrant. 

A shared procedure must either be installed on the program file on which the task is installed, or 
on the shared program file, .S$SHARED. 
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For further information, consult the Link Editor Reference Manual. 


3.9 OVERLAYS 

Overlays are part of a program that resides on disk until explicitly requested. When requested, the 
overlay replaces part of the program previously in memory. The use of overlays can reduce the 
amount of memory required by a program to the amount required for the largest segment needed 
at one time. Programs that do not use overlays are loaded in their entirety into memory for 
execution. 

In the subsequent discussion of overlays, the following definitions apply: 

• Phase — The smallest functional unit that can be loaded as a logical entity during 
execution. The linked object output by the Link Editor contains one object module for 
each phase. 

• Root Phase — The main or memory resident phase (level 0) of a program. 

• Level — The point at which a new phase begins, identified by a level number in the 
overlay structure. Phases having the same level number and same parent (preceding) 
phase are loaded at the same location and are mutually exclusive (they cannot be in 
memory at the same time). 

• Path — A series of phases starting with the root phase and including a successive, 
higher numbered phase at each level. 

The memory requirements of a program can be reduced significantly if it is split into two or more 
overlays that share the same overlay area. A root phase that is not overlaid must be added to the 
program to control the loading of the overlays. However, overlays increase execution time by the 
time required to load the overlays. An effective scheme is to overlay seldom-used phases of a pro- 
gram and retain common code in the root phase. 

3.9.1 Overlay Structures 

Overlay structures are defined by the user and generated by the Link Editor. The structure of an 
overlaid program is dependent upon the relationships between the phases in the program. Phases 
that do not have to be in memory at the same time can overlay each other. These phases are con- 
sidered to be independent in that they do not reference each other either directly or indirectly. 
Independent phases can be assigned the same load address and are loaded only when referenced. 
Refer to the Link Editor Reference Manuai on organizing overlay structures. 

3.9.2 Overlay Loading 

In the root segment or in phases in memory, the user loads overlays from a program file into 
memory with the Automatic Overlay Manager or by issuing the Load Overlay SVC call. 

When the Link Editor is used to produce overlaid programs, the user can specify (by use of the 
LOAD command) that the Link Editor include an Automatic Overlay Manager in the linked output. 
The overlay manager performs automatic overlay loading during execution of the overlaid pro- 
gram. The LOAD command is only applicable when the IMAGE format is selected. 
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3.9.3 Relocatable Overlays 

Overlays are usually loaded into memory at .the load address determined during link edit. 
However, a user may load an overlay elsewhere in memory. Modules installed as relocatable 
overlays in a program file can be relocated by the Load Overlay SVC. This enables users to load 
overlays where space is available rather than where link edited. However, the relocatable overlay 
cannot have references to other overlays. 


3.10 SEGMENT MANAGEMENT 

In addition to program segments already described, disk- or memory-based program segments 
may be provided. These program segments may be dynamically mapped into or removed from the 
memory area of the task. 

Disk-based program segments are installed on program files using the Install Procedure/Program 
Segment SVC. They are loaded into memory and mapped into memory areas of tasks by the seg- 
ment manager. The segment manager maintains a count of the tasks that require the program 
segment, and disposes of program segments that are no longer required. When the program seg- 
ment contents have not changed, or when changes to the disk copy are not permitted, segment 
manager releases the memory space occupied by the program segment. Otherwise, segment 
manager writes the program segment to the program file and releases the memory space. 

A task may request the segment manager to hold a program segment in memory even when no 
^ task currently requires the program segment. This allows passing data to another task that may 

not be currently executing. When the program segment is no longer required, a task may request 
the segment manager to release the program segment. 

Memory-based program segments are created by the segment manager as uninitialized program 
segments, and are mapped into the memory area of the task that requests their creation. The task 
then writes the required data into the program segment. Shared memory-based program 
segments are a means of passing data between tasks in the same job or in different jobs. A task 
must reserve this type of segment or the memory is released when the segment is released. 

Attributes are defined for a segment when it is installed. The attributes of a task segment are 
specified in the Install Task SVC that installs the task on a program file. Similarly, the attributes of 
a procedure segment or a disk-based program segment are specified in the Install Pro- 
cedure/Program Segment SVC. The attributes of a memory-based program segment are specified 
when the program segment is created by the segment manager. The segment attributes are as 
follows: 

• Readable. The segment may be accessed in memory for read operations. 

• System. The segment may only be accessed by system tasks. 

• Memory resident. The segment remains accessible in memory. 

• Replicatable. More than one copy may exist in memory. 

• Share protected. Segment may not be shared concurrently by two or more tasks. 
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• Writable control store. Segment contains executable code that accesses writable con- 
trol store. 

• Execute protected. Segment contents may not be executed. 

• Write protected. Segment contents may not be altered in memory. 

• Updatable. Segment will be written to Its permanent file position on disk if it has been 
marked modified. 

• Reusable. Segment may be used consecutively without reloading. This segment may 
reside on the software cache list while memory space is available for it. 

• Copyable. Segment may be replicated by copying the segment from the memory copy. 

• Privileged. Segment has been installed in a program file as a privileged task segment. 
The task can execute hardware privileged instructions. 

• Software privileged. Segment has been installed in a program file as a software privi- 
leged task segment. The task can issue privileged supervisor calls. 

• Overflow protected. Segment has been installed in a program file with overflow protec- 
tion. During execution, arithmetic overflow is detected as a fatal task error. 


3.11 TASK ATTRIBUTES 

Task attributes are determined during task installation in response to prompts during the IT com- 
mand or the Install Task SVC. The attributes are: 

• Privileged (Hardware and Software) 

• System 

• Priority 

• Memory-Resident 

• Replicatable 

• Protected, Delete and Execute (990/12 only) 

• Copyable 

• Reusable 

• Updatable 

• Arithmetic Overflow Protected (990/12 only) 

• Writable Control Storage (990/12 only) 
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3.11.1 Privileged 

There are two kinds of privilege: hardware and software. The Link Editor cannot be used to install 
privileged tasks on a program file. These tasks must be installed using the Install Task SVC, or the 
IT command. 


3.11.1.1 Hardware Privileged. The PRIVILEGED? prompt of the IT command or the correspond- 
ing flag for the Install Task SVC indicates whether or not a task may issue privileged instructions. 
Only tasks installed as privileged tasks may issue privileged hardware instructions. Most pro- 
grams are nonprivileged and may not use the following 990 Computer assembly language 
instructions: 

• Computer Control Instructions (RSET, IDLE, LREX, LIMI) 

• Real Time Clock Instructions (CKON, CKOF) 

• Mapping Instructions (LMF, LDD, LDS) 

• I/O Instructions (SBO, SBZ, TB, LDCR, STCR) when the communications register unit 
(CRD) address is greater than >E00. 


3.11.1.2 Software Privileged. Task specified as having software privileges may execute all 
system SVCs. The SOFTWARE PRIVILEGED?: prompt of the IT command or the corresponding 
flag for the Install Task SVC commands determine privilege. Nonprivileged tasks may not use the 
following SVCs: 


Install Disk Volume 
Unload Disk Volume 
Initialize Disk Volume 
Disk Management 
Direct Disk I/O 
Open File Unblocked 
Install Task 

Install Procedure/Segment 
Install Overlay 


Delete Task 

Delete Procedure/Segment 

Delete Overlay 

Kill Task 

Read/Write TSB 

Read/Write Task 

Assign Space on Program File 

Initialize Time and Date 


3.11.2 System 

A task is either a system task or a user task. System tasks execute in system memory address 
space (coexistent with other portions of the system). 

A task is defined as a system task by the Install Task SVC or by the user responding YES to the 
SYSTEM TASK? prompt in the IT command during task installation. The Link Editor cannot be 
used to install a system task. 
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3.11.3 Priority 

DNOS requires that each task be installed on a program file at a defined priority level. DNOS pro- 


vides the following 

132 levels of installed priority: 

(Highest) 

0 

Critical System Tasks (Reserved for DNCS) 


R1-R127 

Real-time priorities 


1 

Foreground interactive tasks 


2 

Foreground compute-bound tasks 

(Lowest) 

3 

Background tasks 

(Floating) 

4 

(Priority 1 and 2) 


Priority level 0 is intended for the most critical system functions and is reserved for DNOS internal 
use only. The remaining system tasks are distributed appropriately among the lower priority 
levels with regard to their relative importance. 

Real-time priorities provide the user the capability to supercede all except the most important 
system tasks. For applications which require prompt access to the CPU, DNOS forgoes some 
routine maintenance of system duties in an effort to schedule real-time tasks. 

Priorities 1, 2, 3, and 4 satisfy requirements of most installations. Priority levels 1 and 2 are used 
mainly by programs requiring user interaction. Priority level 1 gives quick response for programs 
interacting with the user’s terminal, while priority level 2 is adequate for programs requiring multi- 
ple disk accesses. 

For programs requiring user interaction and multiple disk accesses, execution priority level 4 
automatically switches between priority levels 1 and 2 as the program executes. Therefore, pro- 
grams requiring user attention can be serviced quickly. 

Priority level 3 is for programs executing in batch or background mode, which require no user 
interaction. 

The priority level of a task is assigned during task installation in response to the PRIORITY? 
prompt of the IT command or the Install Task SVC. The real-time task priorities are assigned with 
the Install Real-Time Task (IRT) command or the Install Real-Time Task SVC. 

DNOS executes tasks according to their priority level by allocating the CPU to the highest priority 
task awaiting execution. As newly-bid tasks enter the system, the tasks awaiting execution are 
requeued according to the newly-bid task priorities. 

If time slicing is enabled, tasks execute for a fixed interval of time. Upon expiration of a time slice, 
the task is rescheduled. Time slicing allows tasks of equal priority to share the CPU in a round- 
robin fashion. (Time slicing and slice value are determined during system generation). 

3.11.4 Memory-Resident 

Tasks may be memory resident (always in memory) or disk resident (in memory when active, but 
possibly swapped to the disk when not active). Most user tasks should be disk resident to free 
memory for other tasks, since some supervisor calls depend on the DNCS swapping facility. 
Memory-resident tasks must be installed on the utilities program file .S$UTIL, or the shared pro- 
gram file .S$SHARED, or on the applications program file defined during system generation. 
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These tasks are disk-resident tasks untii an Initiai Program Load (iPL) is performed. Certain sup- 
port features which depend on swapping (such as dynamic memory ailocation) are not avaiiable 
to a memory-resident task. 

A memory-resident task, even if terminated, occupies memory untii deieted from the program file 
and an IPL is performed. 

Memory-resident tasks are installed on program files by the IT command or the Install Task SVC. 
The Link Editor cannot be used to install memory-resident tasks on a program file. Tasks are 
deleted from program files by the Delete Task (DT) command or the Delete Task SVC. Task 
residency is determined during installation in response to the MEMORY RESIDENT? prompt. 

3.11.5 Replicatable 

Tasks specified as replicatable may have multiple copies concurrently in memory. Replicatable 
tasks are frequently used in multiterminal environments or in industrial applications where 
several similar device types are controlled. A replicatable task allocates multiple copies of a task 
in memory simultaneously and conserves disk space and time. Allocating tasks in this way, 
avoids the requirement of installing a copy of the same task with a different ID for each concur- 
rent activation of the program. Replicatability is determined by the installation response to the 
REPLICATABLE? prompt. 

3.11.6 Protected 

A task may be delete and/or execute protected. Protection is specified during the IT command 
and Install Task SVC. 

3.11.6.1 Delete Protected. A delete-protected task cannot be deleted with the Delete Task (DT) 
command or the Delete Task SVC without removing protection with the Modify Task Entry (MTE) 
command. Delete protection is specified by the DELETE PROTECT? prompt during installation. 

3.11.6.2 Execute Protected. Execute protection applies when a task contains only data and is 
not to be executed. Execute protection is specified by the Install Task SVC or by the EXECUTE 
PROTECT? prompt when using the IT command and applies to only the 990/12 computer. 

3.11.7 Copyable. A task may be specified as copyable by responding to the IN MEMORY 
COPYABLE? prompt of the IT command or by a flag of the Install Task SVC. A copyable task may 
be copied from a copy in memory rather than from the disk copy. 

3.11.8 Reusable. The IN MEMORY REUSABLE? prompt of the IT command or flag of the Install 
Task SVC specifies that after the task terminates, the task segment can be reused by another 
activation of the task. It does not have to be copied either from disk or memory. 

3.11.9 Updatable. The UPDATABLE? prompt of the IT command or flag of the Install Task SVC 
specifies that the task segment on disk may be updated from the in-memory copy. 

3.11.10 Arithmetic Overflow Protection. The 990/12 allows detection of overflow or underflow 
in arithmetic operations. This condition is signaled as a task error. Overflow detection is deter- 
mined by the OVERFLOW CHECKING? prompt of the IT command or by a flag of the Install Task 
SVC. 
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3.11.11 Writable Control Storage. The 990/12 microcode resides in a special memory called the 
control store. The control store consist of the Read Only Memory control store (not discussed 
here) and the writable control store. The writable control store is composed of random-access 
memory (RAM) devices which contain user-written microcode. The writable control store is loaded 
by either DNOS or an assembly language instruction. 

^ portion of the writable control store and three Extended Operation (XOP) levels are reserved for 
Texas Instruments use. DNOS uses XOP levels 13, 14, and 15 and writable control store addresses 
>810 through >9FF to implement system routines. The user should not load microcode routines 
into these locations. Refer to the Microcode Development System Programmer’s Guide for further 
nformation on control store management. 

Jse of the writable control storage is enabled or disabled by the WRITABLE CONTROL 
STORAGE? prompt of the IT command or by a flag of the Install Task SVC. 


3.12 TASK TERMINATION 

Tasks executing under DNOS may terminate normally or abnormally. In either case, the task 
should make provision for termination. If a task does not explicitly terminate using an End Task 
3VC, it either loops indefinitely or it attempts to exceed its memory bounds and causes abnormal 
ermination. A task in an infinite loop may be killed externally by using the Kill Task (KT) or Kill 
Background Task (KBT) commands or by pressing first the RESET (blank orange) then the CON- M 

FROL X key when the task is running in the SCI foreground mode. 

1.12.1 Normal Termination 

o terminate normally, a task executes an End Task SVC. DNOS then releases the resources of 
he task and takes it out of execution. Disk-resident tasks are removed from memory. Memory- 
esident tasks remain in memory and occupy space but do not execute. 

.12.2 Abnormal Termination 

f a task commits a fatal error (for example, illegal instruction, supervisor call, or memory 
sference), and the task entry vector includes an end action address, the routine at that address is 
ctivated. Typically, the end action routine executes an End Action Status SVC, outputs the 
sturned data, and executes an End Task SVC. However, it is possible for the end action routine to 
Tiplement error recovery procedures. If the end action routine commits errors or if the task 
icludes no end action routine, DNOS unconditionally aborts the task and reports the error to the 
ystem log. 


.13 FILE AND DEVICE SERVICES 

iNOS supports input and output operations to various types of devices, and to several types of 
les. In addition, DNOS supports communication between programs, in which each program is 
nalogous to a peripheral device of the other. To include all types of I/O, this manual refers to 
evices, files, and communication channels between programs as I/O resources. 
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3.13.1 I/O Concepts 

DNOS supports two concepts of I/O to resources. Many I/O operations apply to various devices 
and are essentially the same for each device. This concept is called resource-independent I/O. 
Resource-independent I/O allows the programmer to code I/O for terminals, magnetic tape units, 
line printers, card readers, and for sequential files, independently of the device or file. 

A problem with resource-independent I/O is that operation of the resource is restricted to a mode 
that is common to other resources. Resource-specific I/O allows the programming of specific 
capabilities of the device. Resource-specific I/O supports terminals, special industrial devices, 
relative record files, key indexed files, and interprocess communication. 

3.13.2 File and Device I/O 

Several utility operations are required to support device I/O. A device may be specified by either a 
device name or by a logical name. The utility that manages logical names is used to assign a 
logical name. All I/O requires Logical Unit Numbers (LUNOs) which are assigned and deleted by 
another utility. 

File I/O combines the support of the file management and I/O capabilities of DNOS for three types 
of disk files. The file types are: 

• Sequential files 

• Relative record files 

• Key indexed files 

Files may be accessed by a pathname or by a logical name, and a LUNO is required for I/O. The 
utility functions required for device i/O apply to file I/O also. In addition, functions exist to create a 
file, delete a file, verify or change the pathname, apply or change protection, and add or delete an 
alias. 


2270508-9701 


3-15/3-16 





4 




Building an Assembly 
Language Program 


4.1 TEXT EDITOR USE 

The Text Editor interactively creates and modifies fiies of textuai data. The data in these files may 
be assembly language source code, high ievei language source code, or material that is to be 
printed, such as software documentation, memos, or drafts. 

The user, working interactiveiy, invokes and operates the Text Editor from a Model 911 Video 
Display Terminal (VDT). Most of the editing functions are available at both the VDT and hard copy 
terminals, but the means of invoking a particular function may vary depending on the terminal 
type and its current mode of operation. This manual assumes the use of a 911 VDT, being 
operated in VDT mode. Details about operation of a hard copy terminal can be found in the DNOS 
Text Editor Reference Manual. 

The Text Editor is invoked by use of the Execute Text Editor (XE) command. The prompt for the 
filename allows the user to create a new file or edit an existing file. 

To create a new file using the Text Editor, no pathname is entered when the editor is invoked. 
When the Text Editor is used to modify the data in an existing file, the user specifies the file name 
when the Text Editor is invoked. Each record in the input file is numbered, relative to the start of 
the file. The editor is terminated by use of the Quit Edit (QE) command. The user may abort the 
edit, by answering YES to the ABORT? prompt. In this case all modifications and new data are 
discarded. Answering NO to this prompt causes the edited file to be saved in the output file 
specified in response to the OUTPUT FILE ACCESS NAME prompt. 

Errors detected by the Text Editor are described in the DNOS Messages and Codes Reference 
Manual. 


4.2 TERMINAL USE 

Text editing consists of four major types of operations: 

• Command selection and specification 

• Edit control 

• Data display 

• Data entry 

Command selection and specification includes the selection of Text Editor functions that assist 
the user with the management of the text in the source file. The commands are listed in Table 4-1. 
Most of these commands have parameters that are supplied by the user, or, in many cases, by 
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default. After entering each parameter, press the TAB, RIGHT FIELD, or RETURN key to store the 
parameter. In addition, any System Command Interpreter (SCI) command may be called during 
text editing. The terminal must be In the command mode before selecting any command. The ter- 
minal is placed In the command mode by pressing the CMD key. 

Edit control consists of the operations that control the Immediate editing of data. The operations 
available are: altering the current file position, adding data by line, and deleting data by line, alter- 
ing cursor position, adding data by character, and deleting data by character. Edit control opera- 
tions have no parameters. 

Data display manages the display of data on the device. 

Data entry operations control the actual entering of data into the file. 

Command selection from the 91 1 VDT is accomplished by keying in the command and responding 
to the prompts presented on the display screen. Edit control is performed by using the cursor con- 
trol keys and some of the function keys. 

Data entry or editing may occur on any record displayed on the screen by positioning the cursor 
anywhere within the line that contains the record to be edited. Records may be inserted between 
any lines, and may be inserted or deleted in any order. In addition, characters within a line may be 
inserted, deleted, or modified. The Show Line (SL) command, and the Roll Up, Roll Down, Cursor 
Up, and Cursor Down edit control functions listed in Table 4-2 position the file for display. 


4.3 SCI COMMAND USE 

The Text Editor is initiated when the user selects and completes the XE command and terminates 
when the user enters and completes the QE command. Whenever the terminal is in the command 
mode, the Text Editor is suspended and the user may select any SCI command. The commands 
selected when the terminal is in the command mode and the Text Editor is suspended are not 
necessarily Text Editor commands. The Text Editor remains suspended until the XE command or 
another Text Editor command is selected. Then the Text Editor is reactivated, the state that 
existed at the time of suspension is restored, and the entered command is processed. Any Text 
Editor command entered after the Text Editor has been terminated with the QE command causes 
the following message to be displayed: 

U EDITOR-0009 COMMAND IS ALLOWED ONLY WHILE EDITING 

If the user quits SCI (by entering the Quit (Q) command) while the editor is suspended, the QE 
command is automatically invoked, and the user must supply edit termination information. 

Table 4-1 displays the valid commands of the Text Editor. For further information concerning the 
use of the Text Editor refer to the DNOS Text Editor Reference Manual. 
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Table 4-1. Text Editor Commands 


CL — Copy Lines 

MT — Modify Tabs 

DL — Delete Lines 

QE — Quit Editor 

DS — Delete String 

RE — Recover Edit 

FS — Find String 

RS — Replace String 

IF — Insert File 

SL — Show Line 

ML — Move Lines 

SVL — Save Lines 

MR — Modify Roll 

XE — Execute Text Editor 

MRM — Modify Right Margin 

XES — Execute Text Editor 
with Scaling 


4.4 EDIT CONTROL FUNCTIONS 

Edit Control functions are those that specify to the Text Editor precisely where within the file the 
modifications are to be made. Refer to Table 4-2 for the edit control functions supported and keys 
specified on the 911 VDT. 

Table 4-2. Edit Control Functions 

Edit Control Function 

911 VDT 

Key Pressed 

Command Mode 

CMD 

Roll (Display) Up 

FI 

Roll (Display) Down 

F2 

Duplicate To Tab 

F4 

Clear To Tab 

F5 

Display/Suppress Line Numbers 

' F6 

Edit Mode/Compose Mode ^ 

F7 

Begin Line 

RETURN 

Forward Tab ^ 

TAB/SKIP (shifted) 

Erase Rest of Line 

TAB/SKIP 

Forward Space One Character 

CHAR (shifted) 

Backspace One Character 

CHAR ^ 

Back Tab (Left Field) 

FIELD ^ 

Right Margin (Right Field) 

FIELD - (shifted) 

Left Margin 

ENTER 

Erase Characters on Line 

ERASE FIELD 

Delete Line 

ERASE INPUT 
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Table 4-2. Edit Control Functions (Continued) 


Edit Control Function 

911 VDT 

Key Pressed 

Insert Line 

Blank Gray Key 

Repeat (Input of Key) 

REPEAT (plus key) 

Insert Character 

INS CHAR 

Delete Character 

DEL CHAR 

Move Cursor Up 

(Up Arrow) 

Move Cursor Down 

(Down Arrow) 

Move Cursor Right 

^(Right Arrow) 

Move Cursor Left 

“^(Left Arrow) 

Move Cursor Home 

HOME 

Uppercase * 

UPPERCASE LOCK 

Notes: 

’ Alternates display of line numbers (74 data characters) with no display of line numbers (80 
data characters) each time key is pressed. 

^ Alternates modes each time the key is pressed. 

^ SHIFT key must be pressed concurrently with the TAB/SKIP key to achieve the tab function 
on the 911 VDT. 


4.5 TEXT EDITOR EXAMPLE 

The following paragraphs show examples of the Text Editor functions for creating a new file and 
for modifying an existing file. These examples provide a quick reference for the more common 
uses of the Text Editor. This simple program, RESPONSE, is also used in Section 9 to 
demonstrate the linking, installing, executing, and various debugging techniques discussed in 
this manual. Details of editor operations can be found in the DNOS Text Editor Reference Manual. 

4.5.1 Creating a New File 

The following procedure applies to creating a new file using the Text Editor on a 911 VDT in the 
VDT mode. The example assumes that you are properly logged-on, and that SCI is active. Refer to 
preceding section for details on log-on and activating SCI. 

Create a directory .USER, on the system disk, with the Create File Directory (CFDIR) command. 
Enter CFDIR and press the RETURN key. Respond to the prompts as follows: 

[] CFDIR 

CREATE DIRECTORY FILE 

PATHNAME: .USER 
MAX ENTRIES: 15 
DEFAULT PHYSICAL RECORD SIZE: 
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Throughout the examples, files are automatically created in this directory. 

Enter XE and press RETURN to activate the Text Editor. The following prompt appears: 

[]XE 

EXECUTE TEXT EDITOR 

FILE ACCESS NAME: 

Press the RETURN key to indicate that no input file is to be edited. (Press the TAB SKIP key if 
there is a file pathname displayed.) The screen is cleared and the following display is presented in 
the first four columns of row one, with the cursor in column one, row one: 

*EOF 

This display indicates the only record in the file is the end-of-file record. To begin entering data, 
press the RETURN key to enter the first blank line into the file. The end-of-file record is now in line 
two and the cursor is in row one, column one, with the rest of the line blank. Enter data by posi- 
tioning the cursor and keying the data. Press the RETURN key to return to column one and receive 
a new line. Enter the short assembly language program shown in Figure 4-1 . Use the following col- 
umn numbers to promote program readability. 

1. The LABEL field begins in column 1 

2. The OPERATION field begins in column 8 

3. The OPERATOR field begins in column 13 

4. The COMMENT field begins in column 26 or any column on a line with an asterisk (*) in 
column 1 

Any of the edit control functions may be used during data entry, as may any SCI commands (press 
the CMD key to enter the command mode before entering an SCI command). Text editor com- 
mands return the Text Editor to the edit mode upon completion. 

Once all the data has been entered, the Text Editor is terminated by calling the QE command. 
First, press the CMD key to enter the command mode, then enter QE and press the RETURN key. 
The following prompt appears: 

[]QE 

QUIT EDIT 

ABORT?: NO 
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Throughout the examples, files are automatically created in this directory. 

Enter XE and press RETURN to activate the Text Editor. The following prompt appears: 

[]XE 

EXECUTE TEXT EDITOR 

FILE ACCESS NAME: 

Press the RETURN key to indicate that no input file is to be edited. (Press the TAB SKIP key if 
there is a file pathname displayed.) The screen is cleared and the following display is presented in 
the first four columns of row one, with the cursor in column one, row one: 

*EOF 

This display indicates the only record in the file is the end-of-file record. To begin entering data, 
press the RETURN key to enter the first blank line into the file. The end-of-file record is now in line 
two and the cursor is in row one, column one, with the rest of the line blank. Enter data by posi- 
tioning the cursor and keying the data. Press the RETURN key to return to column one and receive 
a new line. Enter the short assembly language program shown in Figure 4-1 . Use the following col- 
umn numbers to promote program readability. 

1. The LABEL field begins in column 1 

2. The OPERATION field begins in column 8 

3. The OPERATOR field begins in column 13 

4. The COMMENT field begins in column 26 or any column on a line with an asterisk (*) in 
column 1 

Any of the edit control functions may be used during data entry, as may any SCI commands (press 
the CMD key to enter the command mode before entering an SCI command). Text editor com- 
mands return the Text Editor to the edit mode upon completion. 

Once all the data has been entered, the Text Editor is terminated by calling the QE command. 
First, press the CMD key to enter the command mode, then enter QE and press the RETURN key. 
The following prompt appears: 

[]QE 

QUIT EDIT 

ABORT?: NO 
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* BEGINNING OF DATA SECTION 
IDT ^RESPONSE' 

* OPENING DATA WORDS 

* 1. WORKSPACE POINTER 

* 2. PC VALUE AT START OF PROGRAM 

* 3. END ACTION ITEM (IF ANY) 

*##**■«■*»**##*•»•*#»•«># »-**-«-****» »•»****■»••«•**■«•«*»***•«■ ■It*#*#*-#-*#**#****##** 


* 

DATA 

WSP 

WORKSPACE POINTER ADDRESS 


DATA 

START 

PC AT PROGRAM BEGINNING 


DATA 

0 

END ACTION (NONE SPECIFIED) 

WSP 

BSS 

32 

WORKSPACE REGISTERS 

OPEN 

DATA 

0 

I/O REQUEST 


BYTE 

>0, >20 

OPEN LUNO >20 


DATA 

0 



DATA 

0 



DATA 

0 



DATA 

0 


MSSGO 

DATA 

0 

I/O REQUEST 


BYTE 

>B, >20 

WRITE ASCII TO LUNO >20 


DATA 

0 



DATA 

GREET 

MESSAGE LOCATION 


DATA 

0 


* 

DATA 

MSSGl -GREET 

MESSAGE LENGTH 


******************************************************************* 

* SPECIFY THE FIRST MESSAGE 

*«*********************-}f-###*******»*###*******#**#*****-»-********** 

* 

GREET DATA >OAOD 

TEXT 'HELLO, PLEASE INPUT NUMBER OF ITEMS ' 

TEXT 'SOLD TODAY. USE 4-DIGIT NUMBERS. ' 

DATA >OAOD 


Figure 4-1. Assembly Language Program Example (Sheet 1 of 3) 
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MBSGl DATA 0 I/O REQUEST 

BYTE >B,.>20 WRITE TO LUIMO >20 

BYTE 0, >40 WRITE WITH REPLY 

DATA ITEM! 

DATA 0 CHARACTERS SPECIFIED IN INPUT ROUTE 

DATA 10 MESSAGE LENGTH 

DATA STRl LOCATION OF INPUT PARAMETERS 

STRl DATA STORE SAVE PARAMETERS IN STORE 

DATA 4 STORE FOUR CHARACTERS 

DATA 0 

STORE BSS 12 

ITEMl DATA >0A0D 

TEXT ^TEM 1 

MSSG2 DATA 0 I/O REQUEST 

BYTE >B,>20 WRITE TO LUNG >20 

BYTE 0, >40 WRITE WITH REPLY 

DATA ITEM2 MESSAGE LOCATION 

DATA 0 

DATA 10 MESSAGE LENGTH 

DATA STR2 

STR2 DATA STORE+4 2ND ITEM- CHARACTERS STORE LOCATION 

DATA 4 
DATA 0 

ITEM2 DATA >OAOD 

TEXT 'ITEM 2 ' 

MSSG3 DATA 0 I/O REQUEST 

BYTE >B,>20 WRITE TO LUNO >20 

BYTE 0, >40 WRITE WITH REPLY 

DATA ITEMS MESSAGE LOCATION 

DATA 0 

DATA 10 MESSAGE LENGTH 

DATA STR3 

STR3 DATA STORE+6 3RD ITEM CHARACTERS STORE LOCATION 

DATA 4 
DATA 0 

ITEMS DATA >OAOD 

TEXT 'ITEM 3 

MSSG4 DATA 0 I/O REQUEST 

BYTE >B.>20 WRITE TO LUNO >20 

DATA 0 

DATA GOODBY MESSAGE LOCATION 

DATA 0 

DATA CLOSE-GOODBY MESSAGE LENGTH 


Figure 4-1. Assembly Language Program Example (Sheet 2 of 3) 
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* FINAL MESSAGE DISPLAYED 

■If W ** -If- *#*****##*■»«■****»*** -If **«#*## If -M- ###•»•#■»•«■■»{• •»■**■«•#•«••«•*•«•* •»• 

■If 


GOODBY 

DATA 

>OAOD 



TEXT 

'THANK YOU 

FOR YOUR PURCHASE. ' 


TEXT 

' HAVE A NICE DAY. ' 


DATA 

>OAOD 


CLOSE 

DATA 

0 

I/O REQUEST 


BYTE 

1, >20 

CLOSE LUNO >20 


DATA 

0 



DATA 

0 



DATA 

0 



DATA 

0 


EOP 

JiL 

BYTE 

>04, 0 

TERMINATE TASK 

ir 

START 

XOP 

©OPEN, 15 

OPEN LUNO >20 


XOP 

GMSSGO, 15 

OPENING MESSAGE 


XOP 

©MSSGl, 15 

INPUT 1 


XOP 

@MSSG2, 15 

INPUT 2 


XOP 

@MSS03> 15 

INPUT 3 


XOP 

@MSSG4, 15 

EXIT MESSAGE 


XOP 

©CLOSE, 15 

CLOSE FILE, UNLOAD/REWIND 


XOP 

©EOP, 15 

TERMINATE TASK 


END 

START 



Figure 4-1. Assembly Language Program Example (Sheet 3 of 3) 


The reply to the ABORT? prompt allows you to either accept (NO response) or discard (YES 
response) the data you entered. A YES response ignores all the data entered and leaves the file in 
its original form. Accept the data by pressing the RETURN key to accept the default value (NO). 
The example uses the NO response. The following display appears; 

QUIT EDIT 

OUTPUT FILE ACCESS NAME: 

REPLACE?: NO 
MOD LIST ACCESS NAME: 

The cursor appears after the colon in the first line of the display. Enter the pathname of the new 
output file, .USER.SOURCE and press the RETURN key. An entry is required since there is no input 
file. 

Press the RETURN key to accept the NO default value of the REPLACE? prompt. The NO response 
allows you to avoid accidentally destroying an existing file. 

Press the RETURN key in response to the MOD LIST ACCESS NAME prompt. 
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Once the file has been created, the Text Editor is no longer active and the terminal returns to com- 
mand mode. The SCI prompt [] and a menu appear. 

4.5.2 Editing an Existing Fiie 

The following example shows the general procedures for editing an existing file by using the Text 
Editor. The file used as Input is the one shown in Figure 4-1. 

I 

First, press the CMD key to enter command mode. Enter XE and press the RETURN key. The 
following appears; 

[]XE 

EXECUTE TEXT EDITOR 

FILE ACCESS NAME: .USER.SOURCE 


The sample file, .USER.SOURCE, is displayed. (Enter .USER.SOURCE as the FILE ACCESS NAME 
response, if .USER.SOURCE is not displayed). Press the RETURN key to display the first 
24-records from the file. The Text Editor is in the edit mode, the cursor is in column one, row one, 
and line numbers are displayed. In this example, we are going to modify the message, HELLO, 
PLEASE INPUT NUMBER OF ITEMS SOLD TODAY. USE 4-DIGIT NUMBERS. We are going to 
change HELLO to GOOD MORNING. To modify the message, perform the following; 

1. Enter the command mode by pressing the CMD key. 

2. Type RS to specify the Replace String command and press the RETURN key. 

3. The prompts appear. Enter the following responses: 

[]RS 


REPLACE STRING 

NUMBER OF OCCURRENCES 
START COLUMN 
END COLUMN 
STRING 
CHANGE 


1 

14 

18 

HELLO 

GOOD MORNING 


4. Press RETURN to activate the command processor. 

5. When the Text Editor completes the string replacement, the line containing the old 
string, now changed, is displayed with the cursor in column one. 

The RS command replaces the string HELLO with the string GOOD MORNING. Note that the 
occurrence number indicates that it replaces the first occurrence of the word HELLO that starts in 
column 14. Care should be taken that the occurrence number corresponds to the intended 
replacement. The advantage of using the RS command is that the text editing system finds the 
word in the file for you and replaces it without your having to manually delete the word and insert 
the correction. 
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Alternatively, the file can be edited manually. Once you have entered the file using the XE com- 
mand, you can page through the text using the F1 function key to page forward, and the F2 func- 
tion key to page backward. When you find the text you want to change, position the cursor over 
the word to be corrected. Use the DEL CHAR key to delete the word or characters. Then press the 
INS CHAR key and type in the characters to be inserted. Note that you can also locate a particular 
word in a file by using the FS command to find a specified string or word. The FS command 
operates very similarly to the RS command. 

Cnee the modifications to the file are complete, press the CMD key to enter the command mode. 
Type QE and press the RETURN key. The following appears: 

[]QE 

QUIT EDIT 

ABCRT?: NC 

Press RETURN in response to the ABCRT? prompt to save the modified file. The following 
appears: 

QUIT EDIT 

QUTPUT FILE ACCESS NAME: .USER.SCURCE 
REPLACE?: NC 
MCD LIST ACCESS NAME: 

Press RETURN to accept .USER.SCURCE as the output file. Enter Y in response to the REPLACE? 
prompt and press the RETURN key twice. The Text Editor now terminates and the SCI prompt [ ] 
and menu return. 


4.6 PROGRAMMING TECHNIQUES 

The first step in developing an Assembly Language program is to clearly define the problem that 
the program is to solve and produce a good flowchart of the proposed solution. Try to break up the 
program into a series of subfunctions that can be coded in smail modules: two to three hundred 
lines is a good limit for the size of a single module. 

Determine what data you will need, both global and local to a subfunction, and how you will struc- 
ture the data. Plan your subroutine linkage: calling, parameter passing, and returning protocols. 

Data structures can be made global by using the External Reference (REF) and External Definition 
(DEF) directives or by putting them into a CSEG. If a CSEG is used, have only one source version 
of each CSEG. This version is copied into the modules requiring the CSEG information by the 
CCPY directive. 


MO 
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Techniques that can be used for subroutine caiis inciude using the Branch (B), Branch indirect 
(BiND), Branch and Link (BL), Branch and Push Link to Stack (BLSK), or Branch and Load 
Workspace Pointer (BLWP) instruction. With the BL instruction, it is necessary to save the con- 
tents of register 11 before making a cail from the caiied routine. This instruction is faster than the 
BLWP instruction and takes iess memory; An advantage of using the BLWP instruction is that a 
fresh set of registers is avaiiabie for use and the contents of the previously used set can be 
accessed by using register 13 as an index register. Status information can be passed back to the 
calling routine by placing data in bits 0-5 (status bits) of register 15. When the Return with 
Workspace Pointer (RTWP) instruction is executed, the contents of register 15 become the con- 
tents of the status register, and the calling routine can test the appropriate bits. 

When coding individual modules, clearly identify the module using the Page Title (TITL) and Pro- 
gram Identifier (IDT) directives. Comments should be included at the beginning of the program 
stating the name and function of the module plus any useful information concerning parameters, 
calling conventions, and various programming methods used in coding the program. Instead of 
constants, use meaningful symbolic names defined with the Define Assembly-Time Constant 
(EQU) directive. Segmentation (use of the CSEG, DSEG, and PSEG directives) is mainly useful for 
coding shared procedures or RAM/ROM partitioned programs, but it can be used as documenta- 
tion. Document the function or meaning of externally referenced symbols as well as locally 
defined symbols. 


J 
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Assembling a Program 


5.1 OPERATING THE MACRO ASSEMBLER 


The Macro Assembler is executed by the DNOS System Command Interpreter (SCI) in either 
background or batch mode. 


To execute the Macro Assembler in background mode, enter the Execute Macro Assembler (XMA) 
command and press RETURN. 

The XMA command prompts appear: 

[] XMA 


EXECUTE MACRO ASSEMBLER 
SOURCE ACCESS NAME 
OBJECT ACCESS NAME 
LISTING ACCESS NAME 
ERROR ACCESS NAME 
OPTIONS 

MACRO LIBRARY PATHNAME 
PRINT WIDTH (CHARS) 
PAGE LENGTH (LINES) 


pathname® 

[pathname®] 

pathname® 

[pathname®] 

[characters] 

[pathname®] 

integer 

integer 


(*) 

(*) 

(*) 

(*) 

(*) 

(*) 

(80) 

(60) 


Enter the pathname or device name in response to the prompts described below. The Wait com- 
mand may be entered after the last response. 


[] WAIT 


— WAITING FOR BACKGROUND TASK TO COMPLETE — 


When the assembler terminates normally, the following message is displayed: 

I ASSEMBLR-0001 MACRO ASSEMBLY COMPLETE, XXXX ERROR(S), YYYY WARNING(S) 

The message displays the number of errors and warnings encountered, if any. Refer to Appendix 
B for the compietion messages. 

A description of the prompts follows: 

SOURCE ACCESS NAME 

The input file or device containing assembly language code to be assembled. 
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OBJECT ACCESS NAME 

The object code output file or device. If this parameter is null, no object output is produced. 
This Is useful for preliminary assemblies to check for errors; since the assembler produces 
no output, it operates faster. 

LISTING ACCESS NAME 

The assembly listing file or device. If DUMY is entered, no assembly listing is produced. 
ERROR ACCESS NAME 

The assembly error output. This file may be viewed by entering the Show File (SF) command. 
If the ERROR ACCESS NAME is null, or if it is the same as the listing file, then errors are 
displayed on the terminal by the Show Background Status (SBS) command. If the device 
DUMY is specified, no error listing is produced. 

The error file contains a complete list of any source records which cause assembly errors 
along with the other errors. If a condition is sensed which prevents the assembler from conti- 
nuing, a message is written to the error file stating what has occurred. Then the user must 
enter the SBS command to view the error messages output by the assembler. Appendix A 
contains a list of abnormal completion messages and possible causes. 


OPTIONS 

Output and list options for the assembler. The user specifies any (or all) of the following op- 
tions, separated by commas. 

XREF — Prints a cross-reference listing at the end of the source and object listing file. 

RXREF — Prints a reduced cross-reference listing at the end of the source and object listing 
file. 

SYMT — Includes a symbol table with the output object code. This option must be specified 
to allow fully symbolic debugging. 

TUNLST — Limits the listing for TEXT directives to a single line. 

BUNLST — Limits the listing for BYTE directives to a single line. 

DUNLST — Limits the listing for DATA directives to a single line. 

MUNLST — Limits the listing for a macro expansion to a single line. TEXT, BYTE, and DATA 
statements and Macro usage often expand to produce multiple lines of code. If these op- 
tions are selected, the statements appear in the listing but the expansion does not. For ex- 
ample, the source statement TEXT ’ABCDEF’ produces the listing: 

41 TEXT ’ABCDEF’ 

42 

43 

44 

45 

46 
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With the TUNLST option specified, only the line 41 TEXT ’ABCDEF’ is produced in the listing. 
FUNL — Overrides the unlist directives. 

NOLIST — Suppresses all listing output, except to the error file. Overrides other directives 
and keywords. 

12 — Specifies the full 990/12 instruction set. If the 990/12 instruction set is not specified, the 
Macro Assembler defaults to the 990/10 instruction set. 

Any of the Option Key words may be abbreviated; for example, any of the following may be 
used for the TUNLST option: 

T 

TU 

TUN 

TUNL 

TUNLS 

TUNLST 

To select more than one option, enter a list of keywords separated by commas. The keywords 
may appear in any order. To select all the options, one could enter the line: 

OPTIONS: X,S,T,B,D,M 

The options specified for this parameter are in addition to any options specified by OPTION 
directives in the source. (Refer to the Assembly Language Reference Manual.) 

MACRO LIBRARY PATHNAME 

A directory containing macro definitions for this assembly. This pathname specification is 
equivalent to specifying the same pathname in a LIBIN directive, except that this pathname 
becomes the system macro library and is retained through stacked assemblies. This 
pathname is printed on the cover sheet of the first module only. 

PRINT WIDTH (CHARS) 

Specifies the length of the lines to be written to the output file. 

PAGE LENGTH (LINES) 

Specifies the number of lines per page in the listing file. 


5.2 FORMAT OF GENERATED FILES 

The assembler prints a source listing of the assembly code and the error or warning messages 
when these conditions are encountered. This section discusses the source listing, the error and 
warning codes output by the assembler, and the object code format. 

5.2.1 Source Listing 

The source listing shows the source statements and the resulting object code. A typical listing is 
shown in Figure 5-1. 


2270508-9701 


5-3 



5 . 2.1 Assembling a Program 


SDSMAC 

ACCESS NAMES TABLE 

SOURCE ACCESS NAME= 
OBJECT ACCESS NAME® 
LISTING ACCESS NAME® 
ERROR ACCESS NAME® 
OPTIONS® 

MACRO LIBRARY PATHNAME* 


PAGE 0001 


. USER. SOURCE 
. USER. OBJECT 
. USER. LISTING 
. USER. ERROR 


RESPONSE SDSMAC 


PAGE 0002 


0001 

0002 

0003 

0004 

0005 

0006 

0007 

0008 

0009 

0010 
0011 
0012 

0013 

0014 

0015 

0016 

0017 

0018 

0019 

0020 
0021 
0022 

0023 

0024 

0025 

0026 

0027 

0028 

0029 

0030 

0031 

0032 

0033 

0034 


0000 

0000 


0000 

0002 

0004 

0006 

0026 

0028 

0029 
002A 
002C 
002E 

0030 

0032 

0034 

0035 

0036 

0033 
003A 
003C 


****#*****»-il^**'»#*****#*##-M-#***-W-*#****#***^f **#**«*# 

* BEGINNING OF DATA SECTION 
IDT 'RESPONSE' 

* OPENING DATA WORDS 

* JL WORKSPACE POINTER 

* 2. PC VALUE AT START OF PROGRAM 

* 3. END ACTION ITEM (IF ANY) 


0006' 

0142' 

0000 

0000 

00 

20 

0000 

0000 

0000 

0000 

0000 

OB 

20 

0000 

003E' 

0000 

0050 


WSP 

OPEN 


MSSGO 


DATA WSP 
DATA START 
DATA 0 
BSS 32 
DATA 0 
BYTE >0. >20 

DATA 0 
DATA 0 
DATA 0 
DAI'A 0 
DATA 0 
BYTE >B;>20 


WORKSPACE POINTER ADDRESS 
PC AT PROGRAM BEGINNING 
END ACTION (NONE SPECIFIED) 
WORKSPACE REGISTERS 
I/O REQUEST 
OPEN LUNO >20 


I/O REQUEST 

WRITE ASCII ON LUNO >20 


DATA 0 

DATA GREET ME 
DATA 0 

DATA MSSGl “GREET 


MESSAGE LOCATION 


MESSAGE LENGTH 


■if ***»*«#**■«<•***#** -K- ** *■«•#*#•«•#***#■»■»•■«■«#■«•*# K- « #*#■«•#■»■*■»• # 

* SPECIFY THE FIRST MESSAGE 


Figure 5>1. Source Listing Example 
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The assembler produces a cover page as the first output in the listing. This cover page contains a 
table that provides a record of the files and devices used during the assembly process. Figure 5-2 
is an example of this output when a macro library is specified. A macro library is a directory con- 
taining files of macro definitions. The assembler directives LIBIN and LIBOUT identify macro 
libraries where macro definitions are read and written. 

The output has two sections: 

• A listing of the parameters that were passed to the assembler via SCI. 

• A list of access names encountered during the first pass of the assembly. 

In the first section, any parameters that have no values are left blank. The fields in the second sec- 
tion are labeled as follows: 

LINE — This field contains the record number in which the access name was encountered. 
KEY — This field contains one of the following: 

LI (indicating a LIBIN usage) 

LO (indicating a LIBOUT usage) 

single character (a single character key assigned to a copy file) 


SDSMAC 

ACCESS NAMES TABLE PAGE 0001 


SOURCE ACCESS NAME= 
OBJECT ACCESS NAME= 
LISTING ACCERSS NAME= 
ERROR ACCESS NAME= 
OPTIONS^ 

MACRO LIBRARY PATHNAME* 


. USER. SRC. TESTl 

. USER. LIST. TESTl 

XREF. SYMT, TUNLST. MUNLST 
. SDSMAC. MACRODEF 


LINE 

KEY 

NAME 

0001 

LI 

. SDSMAC. MACRODEF 
*>. SDSMAC. MACRODEF 

0001 

LO 

MACROS 

=>. SDSMAC. MACRODEF 

0002 

A 

DSC. SYSTEM. TABLES. DOR 

*>DS01. SYSTEM. TABLES. DOR 

0003 

LI 

. SDSMAC. MACRODEF 
=>. SDSMAC. MACRODEF 


Figure 5-2. Output Cover Page Example 
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NAME — This field contains two access names. The first name is the name that appears in 
the source record. The second name, following the = >, is the result of synonym substitution 
in the first name. 

Each page of the source listing has a title line at the top of the page. Any title supplied by a TITL 
directive is printed on this line, and a page number is printed to the right of the title area. The 
printer skips a line below the title line, and prints a line for each source statement listed. The line 
for each source statement contains a source statement number, a location counter value, object 
code assembled, and the source statement as entered. When a source statement results in more 
than one word of object code, the assembler prints the location counter value and object code on 
a separate line succeeding the source statement. The source listing lines for some exampie 
source statements are shown in Figure 5-3: 

The source statement number, 0014 in the example, is a four-digit decimal number. Source 
records are numbered in the order in which they are entered, whether they are listed or not. The 
TITL, LIST, UNL, and PAGE directives are not listed, and source records between a UNL directive 
and a LIST directive are not listed. The difference between source record numbers printed 
Indicates how many source records are not listed. 

The next field on a line of the listing contains the location counter value, a hexadecimal value. In 
the example, 0000 is the location counter value. Not all directives affect the location counter, and 
those that do not affect the location counter leave this field blank. Specifically, the directives IDT, 
REF, DEF, DXOP, EQU, SREF, LOAD, and END leave the location counter field blank. 

The third field normally contains a single blank. However, the assembler places a dash in this 
field when warnings are detected. 

The fourth field contains the hexadecimal representation of the object code placed in the location 
by the assembler, 0006 in the example. The apostrophe following the fourth field indicates that 
the content, 0006, is program-relocatable. A relocatable address is an address which is relative to 
the base address of a particular code segment. The link editor will modify the address by adding 
the base address of the segment to it when the base address is determined. A program- 
relocatable address is an address relative to the beginning of a program segment (PSEG). A quote 
(”) in this location indicates the location is data-relocatable, the address is relative to the base 
address of a data segment (DSEG). A plus ( + ) indicates the label is relocatable with respect to a 
common segment (CSEG). All machine instructions and the BYTE, DATA, and TEXT directive use 
this field for object code. The EQU directive places the value corresponding to the label in the 
object code field. 


0014 

0000 

0006^ 

DATA 

W£;p 

0015 

0002 

0142^ 

DATA 

START 

0016 

0004 

0000 

DATA 

0 

0017 

0006 

WSP 

' BSS 

32 


WORKSPACE POINTER ADDRESS 
PC AT PROGRAM BEGINNING 
END ACTION (NONE SPECIFIED) 
WORKSPACE REGISTERS 


Figure 5-3. Source Statement Listing Exampie 
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The fifth field contains the first n-characters of source statement as supplied to the assembler, 
where n equals a print width between 20 and 80, inclusive. Spacing in this field is determined by 
the spacing in the source statement. The four fields of source statements will be aligned in the 
listing only when they are aligned in the same character positions in the source statements or 
when tab characters are used. 

5.2.2 Error Messages 

The assembler prints the following error message on successive lines of the listing when an error 
is detected: 

*** error description *** 

LAST ERROR AT XXXX 

The second line identifies the statement in which the previous error was detected. 

At the end of the listing is an error summary, as follows: 

NNNN ERRORS, LAST ERROR AT XXXX,YYYY WARNINGS 

NNNN is the count of errors in the assembly. XXXX Identifies the last error detected in the 
assembly. YYYY is the count of the warnings in the assembly. The second lines of the error 
messages link the error messages so that the user may begin at the error summary message and 
readily locate all error messages. In an error-free assembly, the final message is: 

NO ERRORS, NO WARNINGS or NO ERRORS, XXXX WARNINGS 

Several errors detected by the assembler (such as arithmetic overflow while evaluating expres- 
sions) are considered to be only warnings. The programmer should examine the code generated 
when warning messages occur since the results may or may not be the code expected. Warning 
messages are written only to the error file and are not Included in the listing. However, a dash is 
placed in column 11 of the listing where the warning error occurred. Warning messages do not 
include an indication of a previous warning or error. Refer to the Appendix C for listing error 
messages. 

5.2.3 Cross-Reference Listing 

The assembler prints an optional cross-reference listing following the source listing. The format 
of the listing is shown in Figure 5-4. In the LABEL column, the assembler prints each symbol 
defined or referenced in the assembly program. In the second column, the attributes of the sym- 
bol are indicated as a list of single characters. The characters that appear in the second column, 
and their meanings, are listed in Table 5-1. The VALUE column contains a four-digit hexadecimal 
number assigned to the symbol. The DEFN column is the statement number of the defined sym- 
bol. For undefined symbols, the fourth column Is left blank. The REFERENCE column contains a 
list of the statement numbers that reference the symbol. This column is left blank if the symbol is 
unused. An apostrophe in the value column means that the content is program-relocatable. 
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CROSS REFERENCE 


LABEL 


VALUE 

DEFN 

ADDT 


01A8" 

0325 

ADSR 

D 

OlAO" 

0316 

GT 


0006 

0997 


REFERENCES 

0314 

0342 0343 0348 0349 


Figure 5-4. Cross Reference Listing 


Table 5-1 shows the characters that appear in the second column of the cross-reference and their 
meanings. 


Tabie 5-1. Symboi Attributes 


Character 

Meaning 

R 

External reference (REF) 

D 

External definition (DEF) 

U 

Undefined 

M 

Macro name 

S 

Secondary reference (SREF) 

L 

Force ioad (LOAD) 


5.2.4 Object Code 

The assembler produces object code to load into the 990 computer. This object code may be 
linked to other object code modules (or programs) or loaded directly. Object code consists of 
records containing up to 71 ASCII characters each. The format, described in the next paragraph, 
permits corrections of errors without reassembling the program (discussed in Procedures on 
Changing Object Code paragraph). An example of output object code is shown in Figure 5-5. 

5.2.4.1 Object Code Format. The object record consists of a number of tag characters, each 
followed by one to three fields as defined in Table 5-2. The first character of a record is the first 
tag character, which tells the loader which field or fields follow the tag. The next tag character 
follows the end of the field or fields associated with the preceding tag character. When the 
assembler has no more data for the record, the assembler writes tag character 7 followed by its 
field in turn followed by the tag character F. The assembler then fills the rest of the record with 
blanks and a sequence number, and begins a new record with the appropriate tag character. 
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OO15CRESP0NSEA00O0C0006C013CB00O0AOOO6AOO26B00OOBO020B0000BO0OO7F2ilF 

B0000B0000B0000B0B20B0000C003EB0000B004AB0A0DB4845B4C4CB4F2CB20507F1CFF 

34C45B4153B4520B494EB5055B5420B4E55B4D42B4552B204FB4620B4954B454D7F187F 

B5320B534FB4C44B2054B4F44B4159B2E20B2055B5345B2034B2D44B4947B49547F199F 

B204EB554DB4245B5253B2EOOA0086BOAODBOOOOBOB20B0040COOA8BOOOOBOOOA7F1C8F 

C0096C009CB0004B0000A009CA00A8B0A0DB4954B454DB203 1 B2020B0000B0B207F 1 D 1 F 

B0O40C0OC6B0O00B000AC00C0C00A0B0004B0OO0BOAODB4954B454DB2O32B2O207FiEFF 

B0000B0B20B0040C00E4B0000B000AC00DEC00A2B0004B0000B0A0DB4954B454D7F1CEF 

B2033B2020B2000AOOFOBOOOOBOB20BOOOOCOOFCBOOOOB0032BOAODB5448B414E7F1F1F 

B4B20B594FB5520B464FB5220B594FB5552B2050B5552B4348B4153B452EB20487F197F 

B4 1 56B 4520B4 1 20B4E49B4345B2044B4 1 59B2E00A0 1 2C BOAODBOOOOBO 1 20B00007F 1 E6F 

BOOOOBOOOOBOOOOB0400B2FEOC0026B2FEOC0032B2FEOC0088B2FEOCOOB2B2FE07F195F 

C00D0B2FE0C00F0B2FE0C012EB2FE0C013A7F7D9F 

2013C7FEC0F 

RESPONSE 


RESPOOOl 

RESP0002 

RESP0003 

RESP0004 

RESP0005 

RESP0006 

RESP0007 

RESPOOOe 

RESP0009 

RESPOOlO 

RESPOOll 

RESP0012 

RESP0013 

RESP0014 

RESP0015 


Figure 5-5. Object Code Example 


Table 5-2. Object Record Format and Tags 


Tag 


Field 1 


Field 2 


Field 3 


MODULE DEFINITION 
0 PSEG Length 

M DSEG Length 

M Blank Common Length 

M CSEG Length 

M CBSEG Length 


ENTRY POINT DEFINITION 

1 Absolute Address 

2 P-R Address 


LOAD ADDRESS 
9 Absolute Address 

A P-R Address 

S D-R Address 

P C-R Address 


DATA 

B Absolute Value 

C P-R Address 

T D-S Address 

N C-R Address 


Program ID (8) , 

$DATA 

$BLANK 

Common Name (6) 
$CBSEG 


0000 

Common # 
Common # 
CBSEG # * 


Common or CBSEG # 


Common or CBSEG # 


EXTERNAL DEFINITIONS 


5 

P-R Address 

Symbol (6) 

6 

Absolute Value 

Symbol (6) 

W 

D-R/C-R Address 

Symbol (6) 


Common # 
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Table 5-2. Object Record Format and Tags (Continued) 


Tag 

Field 1 

Field 2 

EXTERNAL REFERENCES 


3 

P-R Address of Chain 

Symbol (6) 

4 

Absolute Address of Chain 

Symbol (6) 

X 

D-R/C-R Address of Chain 

Symbol (6) 

E 

Reference Index Number 

Absolute Offset 

SYMBOL DEFINITIONS 


G 

P-R Address 

Symbol (6) 

H 

Absolute Value 

Symbol (6) 

J 

D-R/C-R Address 

Symbol (6) 

FORCE EXTERNAL LINK 


U 

0000 

Symbol (6) 

SECONDARY 

EXTERNAL REFERENCE 


V 

P-R Address of Chain 

Symbol (6) 

Y 

Absolute Address of Chain 

Symbol (6) 

Z 

D-R/C-R Address of Chain 

Symbol (6) 


CHECKSUM 

7 Value 

IGNORE CHECK SUM * 

8 Any Value 

LOAD BIAS * 

D Absolute Address 


Field 3 


Common # 


Common # 


Common # 


END OF RECORD 

REPEAT COUNT (FORTRAN OPTION) * 

R Value Repeat Count — 

PROGRAM ID (SYMT OPTION) * 

I P-R Address Program ID (8) — 

COBOL SEGMENT REFERENCE * 

Q Record Offset CBSEG # — 

Notes: 

All field widths are four-characters unless otherwise specified by numbers in parentheses 

If the first tag is >01, the file is in compressed object format 

P-R Program Segment Relative (address) 

D-R Data Segment Relative (address) 

C-R Common Segment Relative (address) 

* Not generated during assembly. 
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Tag Character 0 

This tag character is foilowed by two fields. 

Field 1 — The number of bytes of program-relocatable code. 

Field 2 — The program identifier assigned to the program by an IDT directive. When no IDT 
directive is entered, the field contains blanks. The linker uses the program identifier to name 
the program. The number of bytes of program-relocatable code determines the load bias for 
the next module or program. The assembler places a single tag character 0 at the beginning 
of each program. 

Tag Character M 

This tag character is used when data or common segments are defined in the program and is 
followed by three fields. COBOL also uses this tag for special code segments. 

Field 1 — The length, in bytes, of data- or common-relocatable code. 

Field 2 — The data or common segment identifier. The identifier is a six-character field con- 
taining the name $DATA (there must be a blank after $DATA) for data segments and $BLANK 
for blank common segments. If a named common segment appears in the program, an M tag 
will appear in the object code with an identifier field corresponding to the operand in the 
defining CSEG directive(s). The name $CBSEG is used for COBOL special code segments. 

Field 3 — A four-character hexadecimal number defining a unique “common number” to be 
used by other tags which reference or initialize data of that particular segment. For data 
segments, this common number is always zero. For common segments (including blank 
common), a common number is assigned to each segment beginning with one and ending 
with the number of different common segments. The maximum number of common 
segments that a program may contain is 126. 

Tag Characters 1 and 2 

These tag characters are used with entry addresses. 

1 — Used when the entry address Is absolute. 

2 — Used when the entry address is program-relocatable. 

Field 1 — The entry address in hexadecimal. One of these tags may appear at the end of the 
object code file. The associated field is used by the loader to determine the entry point at 
which execution starts when the loading is complete. 

Tag Characters 9, A, S, and P 

These tag characters are used with load addresses for data that follows. Tag P contains two 
fields, all the other tags contain only one field. 

9 — Used when the load address is absolute. 

A — Used when the load address is program-relocatable. 
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S — Used when the load address Is data-relocatable. 

P — Used when the load address is common-relocatable. 

Field 1 — The address at which the following data word is to be loaded. A load address is re- 
quired for a data word that is to be placed in memory at some address other than the next ad- 
dress. The load address Is used by the loader. 

Field 2 — The common number for tag character P. 

Tag Characters B, C, T, and N 

These tag characters are used with data words. Tag N contains two fields; all the other tags 
contain only one field. 

B — Used when the data is absolute (an instruction word or a word that contains text 
characters or absolute constants). 

C — Used for a word that contains a program-relocatable address. 

T — Used for a word that contains a data-relocatable address. 

N — Used for a word that contains a common-relocatable address. 

Field 1 — The data word. The loader places the data word in the memory location specified 
in the preceding load address field or In the memory location that follows the preceding data 
word. 

Field 2 — The common number for tag character N. 

Tag Characters 5, 6, and W 

These tag characters are used for external definitions. Tag W consists of three fields; the 
other two tags contain two fields. 

5 — Used when the location is program-relocatable. 

6 — Used when the location is absolute. 

W — Used when the location is data- or common-relocatable. 

The fields are used by the Link Editor to provide the desired linking to the external definition. 
Field 1 — The defined value of the external symbol. 

Field 2 — The symbol which is being defined. 

Field 3 — The common number for tag character W. 
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Tag Characters 3, 4, and X 

These tag characters are used for external references. Fields 1 and 2 are used by the linker to 
provide the desired linking to the external reference. 

3 — Used when the last appearance of the symbol in field 2 of the tag is in program- 
relocatable code. 

4 — Used when the last appearance of the symbol is in absolute code. 

X — Used when the last appearance of the symbol is in data- or common-relocatable 
code. 

Field 1 — The location of the last appearance of the symbol. 

— When the location of the last appearance is absolute zero, no location in the pro- 
gram requires the address corresponding to the reference. 

— When the location of the last appearance is ( not) absolute zero, that location 

serves as the base address of a back chain. The various locations of uses of an ex- 
ternal reference are chainedtogether with each link in the chain pointing to a loca- 
tion which has appeared previously in the object code. Thus the contents of the 
base address of the back chain is the address of the immediately preceding link in 
the chain. The location of the final link will contain absolute zero. 

Field 2 — The external reference. 

Field 3 — Tag character X, which gives the common number. 

For each external reference in a program, there is a tag character in the object code with a 
location or an absolute zero, and the symbol referenced. 

Figure 5-6 illustrates the chain of the external reference (EXTR). 

The object code contains the following tag and fields: 

4C00EEXTR 

At location CODE, the address COOA points to the preceding appearance of the reference. The 
chain Includes both absolute and relocatable addresses. The absolute addresses are CODE, COOA, 
C006, C002, BOOE, BOOA, B006, and B002. The relocatable addresses are 029E, 029A, 0298, 0294, 
0290, and 028E. Each location points to the preceding appearance, except for location 028E, 
which contains zero. The zero identifies location 028E as the first appearance of EXTR, the end of 
the chain. 

Tag Character E 

This tag character is also used for external references. An E tag is used when a non-zero 
quantity is to be added to a reference. 

Field 1 — The index into references identified by 3, 4, V, X, Y, and Z tags in the object code. 
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0229 




DEHONSTRATE EXTERNAL 

0230 




REFERENCELINKINO 

0231 






0232 




REF 

EXTR 

0233 

028C 



RORO 


0234 

028C 

C820 


MOV 

ftEXTR, QEXTR 


028E 

oroo 





0290 

028E' 




0235 

0292 

28E0 


XOR 

SEXTR, 3 


0294 

0290' 





0236 

BOOO 



AORG >B000 

0237 

13000 

3220 


LDCR 

SEXTR, 8 


B002 

0294 ' 




0238 

13004 

0420 


BLWP 

SEXTR 


13006 

B002 




0239 

B008 

0223 


AI 

3, EXTR 


BOOA 

T3006 




0240 

BOOC 

38A0 


MPY 

@EXTR, 2 


BOOE 

BOOA 




0241 

0296 



RORG 


0242 

0296 

C820 


MOV 

eEXTR, GEXTR 


0298 

BOOE 





029A 

0298' 




0243 

029C 

28E0 


XOR 

@EXTR, 3 


029E 

029A' 




0244 

COOO 



AORG 

>C000 

0245 

COOO 

3220 


LDCR 

QEXTR, 8 


C002 

029E ' 




0246 

C004 

0420 


BLWP 

©EXTR 


C006 

C002 




0247 

C008 

0223 


AI 

3/ EXTR 


COOA 

C006 




0248 

COOC 

38A0 


MPY 

©EXTR. 2 


COOE 

COOA 





Figure 5-6. External Reference 


Field 2 — The value to be added to the reference after the reference is resolved. 

The list is maintained by order of occurrence (the first entry in the list is the symbol located 
in field 2 of the first 3, 4, V, X, Y, or Z tag.) The index to that reference in the E tag would be 
0000. 

Tag Characters G, H, and J 

These tag characters are used when the symbol table option is specified with the assembler. 
Tag J contains three fields, all the other tags contain two fields. 
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G — Used when the location or value of the symbol is program-relocatable. 

H — Used when the location or value of the symbol is absolute. 

J — Used when the location or value of the symbol is data- or common-relocatable. 
Field 1 — The location or value of the symbol. 

Field 2 — The symbol to which the location is assigned. 

Field 3 — The common number for tag character J. 

Tag Character U 

This tag character is generated by the LOAD directive. The symbol specified is treated as if it 
were the value specified in an INCLUDE command to the loader. 

Field 1 — All zeros. 

Field 2 — The symbol to be defined. Refer to the LOAD directive in the Assembly Language 
Reference Manual for further information. 

Tag Characters V, Y, and Z 

These tag characters are used for secondary external references. The three fields are used 
by the Link Editor to provide linking to the secondary external reference. 

V — Used when the last appearance of the symbol is in program-relocatable code. 

Y — Used when the last appearance of the symbol is in absolute code. 

Z — Used when the last appearance of the symbol is in data- or common-relocatable 
code. 

Field 1 — The location of the last appearance of the symbol. 

Field 2 — The symbol that is used as the secondary external reference. 

Field 3 — The common number for tag character Z. 

Tag Character 7 

This tag character precedes the checksum, which is an error detection word. The checksum 
is formed as the record is being written. It is the two’s complement of the summed 8-bit 
ASCII character values from the first tag through tag 7. 

Field 1 — The checksum value. 

Tag Character 8 

This tag character is used to ignore the checksum and is not generated at assembly. 

Field 1 — The checksum value to be ignored. 
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Tag Character D 

This tag character is used to specify a ioad bias and is not generated during assembly. 

Fieid 1 — The absoiute address used by the ioader to reiocate the symbois when loading. 
The Link Editor does not accept the D tag. 

Tag Character F 

This tag character indicates the end of record. It may be foilowed by blanks. 

Tag Character R 

This tag character is generated during FORTRAN compilation and represents the repeated 
count of an absolute value (B tags). 

Tag Character I 

This tag character represents the base address of a module and is generated by the Link 
Editor. 

Field 1 — The base address of the named module in the linked object. 

Field 2 — !DT name of the module. 

Tag Character Q 

This tag character is generated during COBOL compilation. This tag is the segment identifier 
to the overlay directory entry. 

Field 1 — The record offset. 

Field 2 — CBSEG number. 

The last record of an object module has a colon (:) in the first character position of the record, 
followed by blanks or a time and date identifying stamp. 

5.2.4.2 Machine Language Format. Some of the data words preceded by tag character B repre- 
sent machine instructions. Comparing the source listing with the object code fields identifies the 
data words that represent machine instructions. Figure 5-7 shows the manner in which the bits of 
the machine instructions relate to the operands in the source statements for each format of 
machine instruction. 

5.2.4.3 Symbol Table. When the SYMT option is specified, the symbol table is included in the 
object code file. One entry, using tag character G or H as appropriate, is supplied for each symbol 
defined in the assembly. 

5.2.4.4 Procedures for Changing Object Code. In most cases, changing the object code to cor- 
rect errors in a program is not recommended. All changes or corrections to a program should be 
made in the source code. Then the program should be reassembled. Failure to follow this princi- 
ple can make subsequent correction or maintenance of the program impossible. The information 
in the following paragraphs is intended for those rare instances when reassembly is not possible. 
Any changes made directly to the object code should be thoroughly documented to show what 
the program actually does, not what the source code says it does. To correct the object code 
without reassembling a program, change the object code by changing or adding one or more 
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X IS A BIT OF THE OPERATION CODE THAT IS EITHER 0 OR 1 ACCORDING TO THE 

SPECIFIC INSTRUCTION IN THE FORMAT 

W/B IS A BIT IN THE OPERATION CODE THAT IS 0 IN INSTRUCTIONS THAT OPERATE ON 

WORDS, AND t IN INSTRUCTIONS THAT OPERATE ON BYTES 
Tn ISA PAIR OF BITS THAT SPECIFY THE ADDRESSING MODE OF THE DESTINATION 

OPERAND, AS FOLLOWS; 

00 = WORKSPACE REGISTER ADDRESSING 

01 = WORKSPACE REGISTER INDIRECT ADDRESSING 
10 = SYMBOLIC MEMORY ADDRESSING WHEN D = 0 
10 = INDEXED MEMORY ADDRESSING WHEN D 0 

1 1 = WORKSPACE REGISTER INDIRECT AUTOINCREMENT ADDRESSING 


D 

"Ts 

S 

NUM 
DISP 
REG 
COUNT 
M 
BC 
CKPT 
COND 
D LENGTH 
S LENGTH 
WIDTH 
POS 
CONST 
NOT USED 
N U 


IS THE WORKSPACE REGISTER FOR THE DESTINATION OPERAND 

IS A PAIR OF BITS THAT SPECIFY THE ADDRESSING MODE OF THE SOURCE OPERAND 
AS SHOWN FOR Tp 

IS THE WORKSPACE REGISTER FOR THE SOURCE OPERAND 
IS THE NUMBER OF BITS TO BE TRANSFERRED 

IS A TWO’S COMPLEMENT NUMBER THAT REPRESENTS A DISPLACEMENT 
IS A WORKSPACE REGISTER ADDRESS 
IS A SHIFT COUNT 

IS A MAP REGISTER FILE NUMBER (0 OR 1) 

IS A BYTE COUNT 

IS A CHECKPOINT REGISTER ADDRESS 

IS A LOGICAL SEARCH CONDITION (EQ,GT,ETC,) 

IS A BYTE COUNT OF THE DESTINATION OPERAND 
IS A BYTE COUNT OF THE SOURCE OPERAND 
IS THE NUMBER OF BITS CONTAINED IN THE OPERAND 
IS A BIT POSITION 

IS A CONSTANT TO BE ADDED TO OR SUBTRACTED FROM A WORKSPACE REGISTER 
IS A GROUP OF BITS NOT USED IN THE INSTRUCTION 
NOT USED 
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Figure 5-7. Machine Instruction Formats 
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records. One additional tag character is recognized by the loader to permit specifying a load 
point. The additional tag character D, may be used in object records changed or added manually. 

Tag character D is followed by a load bias (offset) value. The loader uses this value instead of the 
load bias computed by the loader itself. The loader adds the load bias to all relocatable entry 
addresses, external references, external definitions, load addresses, and data. The effect of the D 
tag is to specify the area of memory for loading. The tag character D and the associated field must 
precede the assembler generated object code. 


NOTE 

Both linked object code and object code loaded by the boot loader 
can be changed without reassembling the program. However, the 
Link Editor will not accept tag character D in changed or added 
object records. 


Correction of the object code may require only changing a character or a word in an object code 
record. The user may duplicate the record up to the character or word in error, replace the incor- 
rect data with the correct data, and duplicate the remainder of the record up to the tag character 7. 
Because the changes the user has made will cause a checksum error when the checksum is 
verified as the record is loaded, the user must change tag 7 to tag 8. 

When more extensive changes are required, the user may write an additional object code record 
or records. Begin each record with a tag character 9, A, S, or P, followed by an absolute load 
address or a relocatable load address. This may be an address into which an existing object code 
record places a different value. The new value on the new record will override the other value 
when the new record follows the other record In the loading sequence. Follow the load address 
with a tag character B, C, or N, and an absolute data word or a relocatable data word. Additional 
data words preceded by appropriate tag characters may follow. When additional data is to be 
placed at a non-sequential address, write another load address tag character (9, A, S, or P), the 
load address and data words, and precede with the appropriate tag character (B, C, or N). When 
the record is full, or all changes have been written, write tag character F to end the record. 

When additional memory locations are loaded as a result of changes, the user must change field 1 
of tag character 0 which contains the number of bytes of relocatable code. For example, when the 
object file written by the assembler contains >1000 bytes of relocatable code, and the user adds 8 
bytes in a new object record, additional memory locations will be loaded. Therefore, the user must 
find the first 0 tag character in the object code file and change the value following the tag value 
from 1000 to 1008. The 7 tag character must be changed to a tag 8 in that record. 

When added records place corrected data in locations previously loaded, the added records must 
follow the incorrect records. The loader processes the records as they are read from the object 
medium. The last record that affects a given memory location determines the contents of that 
location at execution time. 

The object code records that contain the external definition fields, the external reference fields, 
the entry address field, and the final program start field must follow all other object records. An 
additional field or record may be added to include reference to a program identifier with the tag 
character 4. In this case. Field 1 contains 0 and Field 2 contains the first six characters of the IDT 
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character string. External definitions nnay be added using tag character 5 or 6 followed by the 
relocatable or absolute address, respectively, in Field 1. Field 2 contains the first six characters of 
the defined symbol, left justified and blank filled to the right. 


5.3 OPERATING THE ASSEMBLER IN BATCH MODE 

Operating the Macro Assembler in batch mode requires two steps: 

1. Prepare the batch command stream. 

2. Execute the batch command stream using the Execute Batch (XB) or the Execute 
Batch Job (XBJ) command. 

Refer to the DNOS System Command Interpreter (SCI) Reference Manual for information reiated 
to batch mode execution and batch stream examples. 

5.3.1 Batch Stream Structure 

The Batch command stream for macro assembly is depicted in Figure 5-8. 

Any sequential media (cards, cassette, magnetic tape, or sequential file) may be used for the 
batch stream. 

The parameters for records in a Macro Assembly batch stream ^e the following: 

BATCH and EBATCH 

In order to remove unwanted synonyms and default values, the BATCH command should be 
the first command in any batch stream and the EBATCH command should be the last com- 
mand. 

XMA record 

Specifies the Macro Assembly and supplies the required parameters. Parameters are sup- 
plied in the following format: 

field prompt = value 

The prompts assign the first, second, and other parameters associated with the command. A 
prompt is either the full field prompt associated with each parameter, or an abbreviation that 
includes enough characters to identify the field prompt. Cften, only the first character of a field 
prompt has to be entered. For example, to specify the source file .ALFILE, the following 
characters may be used: 

SCURCE = .ALFILE 

or 

S = .ALFILE 
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BATCH 

XMA S=. ALFILE> 0~. ALOBJ, L~. ALL I ST 
EBATCH 


Figure 5-8. Macro Assembly Batch Stream 


When a prompt takes a list as input, the list must be enclosed in parentheses: 

OPTIONS = (X,T,U) 

Each prompt response must be separated from other responses by a comma. For example, the 
following record assembles a source file named .SOURCE, producing an object file (.OBJECT), a 
listing file (.LIST), and reporting errors to .ERR; the options selected are cross reference (XREF) 
and symbol table (SYMT); no macro library is to be used: 


XMA S = .SOURCE,OB = .OBJECT,L = .LIST,E = .ERR,OP = (X,S) 


The only required parameters are SOURCE and LISTING. Other parameters may use initial values 
as indicated in the paragraph on background processing. 

5.3.2 Execute Batch Command 

To execute a batch stream, enter the Execute Batch (XB) command and press RETURN. The 
following appears: 

Prompts: 

EXECUTE BATCH 

INPUT ACCESS NAME: pathname® 

LISTING ACCESS NAME: pathname® 

Prompt Details: 

INPUT ACCESS NAME: 

The pathname from which SCI should read the batch command stream. 

LISTING ACCESS NAME: 

The pathname of a device or file to which SCI should write the results of the batch command 
stream execution. This device or file must not be used by any command in the batch com- 
mand stream. 

Example: 

In the following example, the XB command will execute a batch stream from a file and output 
the results of the batch command stream to a line printer. 

[]XB 

EXECUTE BATCH 

INPUT ACCESS NAME: MY.BATCH 
LISTING ACCESS NAME: LP01 
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5.3.3 Execute Batch Job 

The Execute Batch Job (XBJ) command allows a user to create a batch job with different 
operating parameters than those of the creating job. 

To execute the XBJ command, enter XBJ and press RETURN. The following appears: 

Prompts: 

EXECUTE BATCH SCI JOB 

JOB NAME: alphanumeric 
USE CURRENT USER ID?: YES/NO (YES) 

LOGICAL NAME TABLE PATHNAME: [filename®] 

SYNONYM TABLE PATHNAME: [filename®] 

If NO is the response to the USE CURRENT USER ID? prompt, the following prompts are 
displayed: 

EXECUTE BATCH SCI JOB 

USER ID: alphanumeric 
PASSCODE: [characters] 

ACCOUNT ID: [characters] 

If the user’s response to the SYNONYM TABLE PATHNAME prompt is null, the following 
prompts are displayed on the user’s terminal: 

INPUT ACCESS NAME: pathname® 

LISTING ACCESS NAME: pathname® 

Prompt Details: 

JOB NAME: 

A one- to eight-character, user-defined string by which the user wishes to reference the job. 
USE CURRENT USER ID: 

If YES is specified, the current user ID is used. If the response is NO, the user must specify a 
new user ID. 

USER ID: 

The user ID to be associated with the new job. A response to this prompt is required if the 
response to the USE CURRENT USER ID? prompt was NO. 

PASSCODE: 

The passcode corresponding to the user ID of the new job. 

ACCOUNT ID: 

A 1- to 16-character string that is the account ID for the new job. 


2270508-9701 


5-21 



5 . 3.4 Assembling a Program 


LOGICAL NAME TABLE PATHNAME: 

The file name containing the logical names to be passed to the new job. A null response 
passes the creating job’s logical names. Any other entry is considered a file name containing 
logical names established by the Snapshot Name Definition (SND) command. The default for 
this prompt is a null value. 

SYNONYM TABLE PATHNAME: 

The file name containing the set of synonyms to be used by the new job. The file must have 
been created via the SND command and must include the new job’s input and listing access 
names in its parameter list. If a null response is entered, the INPUT ACCESS NAME and 
LISTING ACCESS NAME prompts are displayed at the user’s terminal. 

INPUT ACCESS NAME: 

The pathname of a device or file where the job command stream resides. 

LISTING ACCESS NAME: 

The pathname of a device or file where the job execution results are to be listed. 


Example: 

In the following example, suppose a batch job Is created that creates a file, outputs data to the 
file, prints the file contents, then deletes the file. The command stream to perform these func- 
tions resides in a file named SYS1.KC0017.INPUT, and the logical names and synonyms of the 
creating job will be passed to the new job, The XBJ command could be used to create and execute 
the batch job as shown below: 


[] XBJ 

EXECUTE BATCH SCI JOB 

JOB NAME 
USE CURRENT USER ID? 
LOGICAL NAME TABLE PATHNAME 
SYNONYM TABLE PATHNAME 
INPUT ACCESS NAME 
LISTING ACCESS NAME 


BATCH 

YES 


SYS1.KC0017.INPUT 

LP01 


5.3.4 Operating from Card Reader 

To execute a batch stream on a deck of cards In the card reader, the macro assembly stream 
should be in the prescribed order as shown in Figure 5-9. 
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Execute the assembly stream by entering the XBJ command and entering CR01 in response to the 
INPUT ACCESS NAME prompt, as shown below: 

[]XBJ 

EXECUTE BATCH JOB 

JOB NAME: BATCH 
USE CURRENT USER ID?: YES 
LOGICAL NAME TABLE PATHNAME: 

SYNONYM TABLE PATHNAME: 

INPUT ACCESS NAME: CR01 
LISTING ACCESS NAME: .USER.LFILE 
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6.1 SUPPORTED FEATURES 

The Link Editor links separate object modules together to form a single program which runs under 
DNOS. 

The following Link Editor features are supported by DNOS: 

• Automatic overlay loading 

• Random libraries 

• Sequential libraries 

• ASCII, compressed and image format 

• Absolute memory partitioning. 

For more information about these features, consult the DNOS Link Editor Reference Manuai. 


6.2 LINK EDIT CONTROL FILE 

The first step in performing a link edit run is to write a control file defining the link edit functions. 
The control file can be written using the DNOS Text Editor. The control file contains link edit com- 
mands and the names of any object modules. Object modules not included in the control file may 
be on disk, tape, cassette, cards, or diskette. 

Table 6-1 presents a brief description and syntax for the Link Editor commands. Refer to the Link 
Editor Reference Manuai for complete details on the commands. 
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6.2 Linking and instaiiing a Program 


Table 6-1. Link Editor Commands 


Command 

Description 


Symbol Resolution Commands 

LIBRARY 

Specifies the libraries to be searched for unresolved external 
references 

AUTO 

Specifies use of automatic symbol resolution 

NOAUTO 

Inhibits use of automatic symbol resolution 

SEARCH 

Specifies that the symbols in the random or sequential libraries 
specified are to be resolved when this command is issued 

FIND 

Spejcifies that the symbols in the random or sequential libraries 
specified are to be resolved when this command is issued 

Procedure, Task and Overlay Linking Commands 

PROCEDURE 

Defines a phase be installed as a procedure 

TASK 

Defines a phase be installed as a task 

PHASE 

Specifies a new object module in the linked object file and 
states the level and name of the phase 

ALLOCATE 

Controls the relative position of program, data, and common 
segments 

LOAD 

Includes the overlay manager when the FORMAT IMAGE com- 
mand is used 

NOLOAD 

Specifies that the overlay manager and its tables be excluded 
from the linked output 

SHARE 

Specifies modules to share the same data area 

PARTIAL 

Performs a partial link edit and outputs a normal tagged object 
or compressed tagged object output file 

NOTGLOBAL 

Identifies symbols defined in the current phase as not global 

ALLGLOBAL 

Declares all external definitions in the current phase to be 
global symbols 

GLOBAL 

Identifies symbols defined in the current phase as globai 

DUMMY 

Suppresses the linked output for the defined phase, procedure, 
or task in which it appears 
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Table 6-1. Link Editor Commands (Continued) 


Command 


Description 


Procedure, Task and Overlay Linking Commands (Continued) 


ADJUST 

SYMT 

NOSYMT 

INCLUDE 

FORMAT 

MAP 

NOMAP 

PAGE/NOPAGE 

ERROR/NOERROR 


PROGRAM 

DATA 

COMMON 


Specifies alignment of a phase or module within a phase 
Symbol Processing Commands 
Includes the symbol tables In the linked object module 
Omits the symbol tables from the linked object module 

Execution and Listing Option Commands 

Defines the modules or files of modules to be Included in the 
linked object output 

Defines the format of the linked output (normal tagged object, 
compressed tagged object, or memory Image format) 

Controls the format of the link map 

Suppresses the load map listing 

Controls the format of the output listing 

Specifies whether link editor is to continue after it encounters 
an error 

Absolute Memory Partitioning Commands 

Specifies the starting location counter value for the program 
segments 

Defines the starting location counter value for data segments 

Defines the starting location counter value for the specified 
common segments 
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6.3 Linking and instaiiing a Program 


6.3 LINK EDITOR OPERATION WITH DNOS 

The Link Editor is executed by entering the Execute Link Editor (XLE) command. Enter XLE and 
press the RETURN key. The following appears: 

[]XLE 


EXECUTE LINK EDITOR 


CONTROL ACCESS NAME: 

pathname® 

(*) 

LINKED OUTPUT ACCESS NAME: 

[pathname®] 

(*) 

LISTING ACCESS NAME: 

[pathname®] 

(*) 

PRINT WIDTH (CHARS): 

integer 

(80) 


After entering the last response to the prompts, enter the WAIT command. The message 

I LINKER-0001 LINK EDITOR COMPLETED, 0 ERRORS, 0 WARNINGS: 

appears on the screen when the linking process terminates. Press the CMD key to return to the 
command mode. 

The prompts for the XLE command are described below: 

CONTROL ACCESS NAME: 

The pathname of the Link Editor control file. The control file can be on a sequential disk file, 
or any sequential device such as a tape unit, cassette unit, or card reader. 

LINKED OUTPUT ACCESS NAME: 

The access name of the sequential device or file where the output of the Link Editor is writ- 
ten. If the object output is not desired, the user may specify DUMY which will suppress the 
generation of the output. Use of the DUMY value allows for a trial run to ensure that no errors 
occur. 

If the FORMAT command specifies the IMAGE option, the entry made in response to the 
LINKED OUTPUT ACCESS NAME prompt must be a DNOS program file or a DNOS image file. 

LISTING ACCESS NAME: 

The access name of the device or file where the load map listing is written. If the listing out- 
put is not desired, the user may specify DUMY which will suppress the listing. The value 
entered in response to the prompt can be any valid DNOS access name, synonym, or device 
name. 

For a description of the load map listing, refer to the DNOS Link Editor Reference Manuai. 

PRINT WIDTH (CHARS): 

The width of the print line. 
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The following example shows the responses for the prompts when the control file is on 
.USER.CNTRLINK, the output file is .USER.LNKOUT, the listing device is line printer one (LP01), 
and the initial PRINT WIDTH (CHARS): value is accepted: 


[]XLE 


EXECUTE LINK EDITOR 

CONTROL ACCESS NAME 
LINKED OUTPUT ACCESS NAME 
LISTING ACCESS NAME 
PRINT WIDTH (CHARS) 


.USER.CNTRLINK 

.USER.LNKOUT 

LP01 

80 


6.4 PROGRAM LINKING AND DIRECTIVES 

Since the assembler includes directives that generate the information required to link program 
modules, it is not necessary to assemble an entire program in the same assembly. A long program 
may be divided into separately assembled modules to avoid a long assembly or to reduce the sym- 
bol table size. Also, modules common to several programs may be combined as required. Pro- 
gram modules may be linked by the Link Editor to form a linked object module that may be stored 
on a library and/or loaded as required. The following paragraphs define the linking information 
that must be included in a program module. 

6.4.1 External Reference Directives 

Each symbol from another program module must be placed in the operand field of an REF or 
SREF directive in the program module that requires the symbol. 

6.4.2 External Definition Directive 

Each symbol defined in a program module and required by one or more other program modules 
must be placed in the operand field of a DEF directive. 

6.4.3 Program Identifier Directive 

Program modules linked by the Link Editor should include an IDT directive. The module name 
specified in the IDT directive should be unique. 

6.4.4 Linking Program Modules 

The Link Editor matches symbols from REF directives and symbols from DEF directives in a 
similar manner within a program phase. The Link Editor follows linking commands to determine 
the modules to be linked. IDT character strings are not matched with REF directive operands. 


6.5 LINK MAP 

Figure 6-1 shows the DNOS format of the output listing generated by the Link Editor. This exam- 
ple linked three modules to form a task. The three modules are named SUBT1, SUBR1, and MODX, 
and the task itself is named LSCAN. 
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6.5 Linking and instaiiing a Program 


LIIMKER 

COMMAND LIST 

TASK LSCAN 

LIBRARY . MSK. EXO 

INCL . SUBTl 

INCL .SUBRl 

INCL . MODX 

END 

LINKER 
LINK MAP 

CONTROL FILE * . MSK. EXO. MODCOM 
LINKED OUTPUT FILE = DUMY 
LIST FILE = . MSK. LST 
OUTPUT FORMAT =* ASCII 


LINKER 






PHASE 0, 

LSCAN ORIGIN ~ 0000 LENGTH 

= 0056 

MODULE 

NO 

ORIGIN 

LENGTH 

TYPE 

DATE 

SUBTl 

1 

0000 

0034 

INCLUDE 

04/26/80 

SUBR 1 

2 

0034 

OOOC 

INCLUDE 

04/26/80 

MODX 

3 

0040 

0016 

INCLUDE 

04/26/80 




D E F I 

N I T I 0 

N S 


NAME VALUE NO 
DC^AMP 002A 1 

*SUBR1 0034 2 


NAME VALUE NO 
DC^RET 002C 1 

*SUBT1 O^'OO 1 


NAME VALUE NO 
DC^TX 002E 1 


UNRESOLVED REFERENC 
NAME COUNT NO NAME COUNT NO NAME COUNT NO 
SUBR 1 1 


LINKING COMPLETED 


Figure 6-1. Link Edit Output Listing 


PAGE 1 


PAGE 2 


PAGE 3 
ENTRY = 0000 


TIME CREATOR 

13:27:49 SDSMAC 
13:30:29 SDSMAC 
13: 33: 35 SDSMAC 


NAME VALUE NO 
*MODX 0040 3 


E S 

NAME COUNT NO 
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Page one in the example, titled COMMAND LIST, is the list of the control file used to control the 
linking operations. This list is generated at the beginning of each Link Edit. Page two, titled LINK 
MAP, lists the parameters entered at the terminal when the Link Editor was activated. This page 
also gives the format of the output from the Link Editor (ASCII in the example). The last page, page 
three, is the actual link map. The PHASE name, address of the ORIGIN, LENGTH of the linked ob- 
ject code, and the execution ENTRY point are defined in the top line. 

The subdivisions of the link map are listed below; 

MODULE 

The module names (identified by the IDT directives) included in the phase. 

ORIGIN 

The beginning of the module relative to the beginning of the program. 

LENGTH 

The length of the module, in bytes. 

TYPE 

The method by which the module was included in the phase (INCLUDE, SEARCH com- 
mand, LIBRARY auto resolution). 

TIME 

The time the module was created. 

CREATOR 

The assembler or compiler that generated the module (SDSMAC). 

DEFINITIONS 

The entries under this heading describe all external definitions (DEFs) in the phase. 

NAME — The symbol specified by the DEF statement. 

VALUE — The address within the phase associated with the symbol. 

NO — The number of the module within the phase in which the symbol is DEFed. 


NOTE 

Names that are DEFed within the phase but not referenced (REFed) 
within the program are preceded by an asterisk (*). Symbols that are 
self-defining (absolute) are Identified by a trailing asterisk (*). 


2270508-9701 


6-7 



6.6 Linking and Instaiiing a Program 


UNRESOLVED REFERENCES 

The entries under this section of the listing defines any references that are unresolved within 
the phase. 

NAME — The symbol that was referenced and could not be found. 

COUNT — The number of times the symbol was referenced. 

NO — The module within the phase in which the reference occurred. 

Unresolved references cause a warning message to be output at the end of the link map. The 
message is of the form: 

n WARNINGS 

where n is the number of unresolved references. 


NOTE 

Partial link edits do not produce a warning message for unresolved 
references. 


The end of the Link Edit processing is indicated by the following message: 
**** LINKING COMPLETED 


6.6 LINK EDITOR EXAMPLES 


The following paragraphs contain examples of Link Edits on a DNOS system. Provided for each 
example is the complete Link Map (containing a copy of the control file) and the parameters 
entered when the Link Editor is called from a VDT. 

6.6.1 Single Task With No Procedure — Example 

The example shown in Figure 6-2 illustrates the use of the Link Editor to build a task consisting of 
two modules with no attached procedures. The parameters entered in response to the prompts 
are as follows: 


[]XLE 


EXECUTE LINK EDITOR 

CONTROL ACCESS NAME 
LINKED OUTPUT ACCESS NAME 
LISTING ACCESS NAME 
PRINT WIDTH (CHARS): 


.USER.TEST1 

DUMY 

.USER.TEST1L 

80 


Note that no linked output is created since the LINKED OUTPUT ACCESS NAME: DUMY, was 
used. The default value was used in response to the PRINT WIDTH (CHARS) prompt. 
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LINKER PAGE 1 

COMMAND LIST 

TASK RANDOM 
INCLUDE . USER. TESTX 

INCLUDE . USER. SORT 

END 

LINKER PAGE 2 

LINK MAP 

CONTROL FILE == . USER. TESTl 
LINKED OUTPUT FILE *= DUMY 
LIST FILE « . USER. TESTIL 
OUTPUT FORMAT * ASCII 

LINKER PAGE 3 

PHASE 0, RANDOM ORIGIN =* 0000 LENGTH « 005E ENTRY « 0000 


MODULE 

NO 

ORIGIN 

LENGTH 

TYPE 

DATE 

TIME 

CREATOR 

TESTX 

1 

0000 

0032 

INCLUDE 

04/26/80 

13: 09: 29 

SDSMAC 

SORT 

2 

0032 

002C 

INCLUDE 

04/26/80 

13: 12: 48 

SDSMAC 


DEFINITION 


NAME 

VALUE NO NAME VALUE NO 

NAME VALUE NO 

NAME 

VALUE NO 

SORT 

0032 2 





LINKING COMPLETED 





Figure 6-2. Single Task, No Procedure Example 
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6 . 6.2 Linking and instaiiing a Program 


The control file defines the task name as being RANDOM, with files TESTX and SORT included by 
use of the INCLUDE command. The default format, ASCII, is used. 


The Link Map shows that PHASE 0, RANDOM, begins at relative address 0000 and has a length of 
>005E bytes. Module TESTX is >32 bytes in length and begins at relative address 0000, and 
module SORT is >2C bytes in length and begins at relative address >32. 


Only one external definition, SORT, is made. 

6.6.2 Task with Two Attached Procedures ~ Example 

The example shown in Figure 6-3 is a Link Edit for a program having a task, CONTRL, and two 
attached procedures, TABLE and ROUT. The parameters entered when the Link Editor is activated 
from the VDT are as follows: 

[]XLE 


EXECUTE LINK EDITOR 

CONTROL ACCESS NAME 
LINKED OUTPUT ACCESS NAME 
LISTING ACCESS NAME 
PRINT WIDTH (CHARS) 


.USER.EXC.TWOP 

DUMY 

.USER.LST 

80 


Note that within the control file, the procedures are defined before the task. On the Link Map, the 
procedures are also presented first. Page three of the example contains the Link Map for Pro- 
cedure 1, TABLE, which has an origin at relative address 0000 and a length of eight bytes. One 
module, ALPHA, is included in TABLE and it Is taken from random library .USER.EXO. 


Procedure 2, ROUT, is shown in the Link Map on page four of the example and consists of one 
module, BETA, which has a relative origin of >20 and a length of eight bytes. BETA is specified by 
an INCLUDE command and is read from the random library .USER.EXO. Note that BETA contains 
one external definition, B$BY, that Is not referenced. External definitions that are not referenced 
are denoted by a preceding asterisk (*). 


PHASE 0, shown on page five of the example, Is defined by the TASK command and is named 
CONTRL. CONTRL consists of one module, TGAMA, specified by the INCLUDE command and 
read from the random library .USER.EXO. CONTRL has an origin at relative address >40 and a 
length of >3C bytes. CONTRL contains no external definitions. 


The two procedures have to be installed before the task Is installed using the Install Procedure 
(IP) and the Install Task (IT) commands, respectively. 

The output format of the Link Edit is ASCII. 
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LINKER ' PAGE 1 

COMMAND LIST 

LIBRARY . USER. EXO 

PROCEDURE TABLE 

INCL (ALPHA) 

PROC ROUT 
INCLUDE (BETA) 

TASK CONTNL 
INCL (TGAMA) 

END 


LINKER PAGE 2 

LINK MAP 

CONTROL FILE = . USER. EXC. TWOP 
LINKED OUTPUT FILE = DUMY 
LIST FILE « . USER. LST 
OUTPUT FORMAT « ASCII 
LIBRARIES 

NO ORGANIZATION PATHNAME 

1 RANDOM . USER. EXC 

LINKER PAGE 3 

PROCEDURE 1, TABLE ORIGIN = 0000 LENGTH == OOOS 

MODULE NO ORIGIN l.ENGTH TYPE DATE TIME CREATOR 

ALPHA 1 0000 0008 INCLUDE.! 04/2<b/80 13:52:07 SDSMAC 

DEFINITIONS 

NAME VALUE NO NAME VALUE NO NAME VALUE NO NAME VALUE NO 

M$A 0000 1 M*B 0002 1 mC 0004 1 M^D 0006 1 


Figure 6-3. Task, Two Attached Procedures Example (Sheet 1 of 2) 
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6 . 6.3 Unking and Installing a Program 


LINKER PAGE 4 

PROCEDURE 2, ROUT ORIGIN = 0020 LENGTH = 0008 


MODULE 

NO 

ORIGIN 

LENGTH 

TYPE 

DATE 

TIME 

CREATOR 

BETA 

2 

0020 

OCOO 

INCLUDE, 1 

04/26/80 

13: 54: 44 

SDSMAC 


DEFINITIONS 

NAME VALUE NO NAME VALUE NO NAME VALUE NO NAME VALUE NO 

B$AX 0020 2 *B$I3Y 0026 2 


LINKER PAGE 5 

PHASE 0, CONTRL ORIGIN * 0040 LENGTH 003C ENTRY « 0000 
MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 
TGAMA 3 0040 003C INCLUDE, 1 04/26/80 14:05:28 SDSMAC 

LINKING COMPLETED 


Figure 6-3. Task, Two Attached Procedures Example (Sheet 2 of 2) 


6.6.3 Link Edit Example With Overlay 

The listing shown in Figure 6-4 illustrates the Control Stream, Link Map, parameters, and struc- 
ture required to produce an overlay structured program. Automatic Overlay Loading is not used in 
the example. 

The program with overlays in Figure 6-4 consists of seven modules and three levels. The pro- 
cedure, XS$AM, begins at relative location 0000. Phase 0, T$CAL, is specified by the TASK com- 
mand, consists of one module, ROOT, and begins at relative address >40. Procedure P$ONE and 
task T$CAL are always memory resident when the task is active. 

The program uses four overlays, two at level one and two at level two. The level one phases are 
0$0NEA, which consists of the module MODI, and 0$0NEB, which consists of modules MOD4 
and MODDAT. Both phases begin at relative location >90. Note that only one of these phases can 
be in memory at one time. 
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LINKER PAGE 1 

COMMAND LIST 

PROCEDURE P^ONE 

INCLUDE . LXO. XS^^AM 

TASK T^CAL 
INCL . LXO. ROOT 
PHASE 1.0$0NEA 
INCL . LXO. OVIA 
PHASE 2, OitTWOA 
INCL . LXO. 0V2A 
PHASE 2, 0-^TWOB 
INCL . LXO. 0V2B 
PHASE 1, O^ONEB 
INCLUDE . LXO. OVIB 
INCL . LXO. OVIBD 
END 

LINKER PAGE 2 

LINK MAP 

CONTROL FILE = .LX. CON 
LINKED OUTUT FILE DUMY 
LIST FILE = . LX. LST 
OUTPUT FORMAT = ASCII 


LINKER PAGE 3 

PROCEDURE 1. P^ONE ORIGIN == 0000 LENGTH = 003E 

MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 

XS^AM 1 0000 003E INCLUDE 04/26/80 14:34:03 SDSMAC 


DEFINITIONS 


NAME 

VALUE 

NO 

NAME 

VALUE 

NO 

NAME 

VALUE 

NO 

NAME 

VALUE 

NO 

D$ROT 

S$ZXC 

0034 

0020 

1 

1 

S$ASD 

0000 

1 

S$FGH 

0002 

1 

S$JKL 

OOOC 

1 


Figure 6-4. Overlaid Program Example (Sheet 1 of 3) 
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6 . 6.3 Linking and instaiiing a Program 


LINKER 




PAGE 

PHASE 0, T^CAL ORIGIN = 0040 

LENGTH 

= OOAO 

ENTRY « 0000 

MODULE NO ORIGIN LENGTH 

TYPE 

DATE 

TIME 

CREATOR 

ROOT 2 0040 0050 

INCLUDE 

04/26/80 

15: 20: 37 

SDSMAC 


LINKER 


PAGE 5 


PHASE 1, OtfcONEA ORIGIN « 0090 LENGTH « 0028 ENTRY = 0000 


MODULE NO ORIGIN LENGTH TYPE 

MODI 3 0090 0028 INCLUDE 


DATE TIME CREATOR 
04/26/BO 15:20:37 SDSMAC 


DEFINITIONS 

NAME VALUE NO NAME VALUE NO NAME VALUE NO NAME VALUE NO 
SUBRl 0090 3 


LINKER 


PAGE 6 


PHASE 2, O^TWOA ORIGIN = 00B8 LENGTH = 0028 ENTRY = 0000 


MODULE NO ORIGIN LENGTH 

M0D2 4 00B8 0028 


TYPE DATE TIME CREATOR 

INCLUDE 04/26/80 15:31:12 SDSMAC 


DEFINITIONS 

NAME VALUE NO NAME VALUE NO NAME VALUE NO NAME VALUE NO 
SUBR2 OOBS 4 

Figure 6-4. Overlaid Program Example (Sheet 2 of 3) 
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LINKER PAGE 7 

PHASE 2. O^TWOB ORIGIN * GOBS LENGTH 0028 ENTRY « 0000 


MODULE 

NO 

ORIGIN 

LENGTH 

TYPE 

DATE TIME 

CREATOR 

M0D3 

5 

00B8 

0028 

INCLUDE 

04/26/80 15:31:50 

SDSMAC 


DEFINITIONS 

NAME VALUE NO NAME VALUE NO NAME VALUE NO NAME VALUE NO 
SUBR3 00B8 5 


LINKER PAGE 8 

PHASE 1, O^ONEB ORIGIN « 0090 LENGTH « 0034 


MODULE 

NO 

ORIGIN 

LENGTH 

TYPE 

DATE 

TIME 

CREATOR 

M0D4 

6 

0090 

0C2C 

INCLUDE 

04/26/80 

15; 40: 57 

SDSMAC 

MODDAT 

7 

OOBC 

0003 

INCLUDE 

04/26/80 

15: 47: 16 

SDSMAC 


DEFINITIONS 

NAME VALUE NO NAME VALUE NO NAME VALUE NO NAME VALUE NO 

SUBR4 0090 6 TABLE OOBC 7 

LINKING COMPLETED 


Figure 6-4. Overlaid Program Example (Sheet 3 of 3) 
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6.7 LINKED FORMAT OUTPUT OPTIONS 

The following paragraphs define the listing output options. The link edit FORMAT command 
defines the format of the linked object code. 

The syntax of the FORMAT command is as follows: 

ASCII 

FORMAT COMPRESSED 

IMAGE [, REPLACE] [, priority] 

There are three formats supported by the Link Editor: normal tagged object, compressed tagged 
object, and memory image format. The default is 4. 

6.7.1 Normal Tagged Object 

This format consists of ASCII characters and ASCII control tag characters. Except for COBOL, it 
must be output to a sequentialfile. Except for COBOL, the normal tagged object is not executable 
and must be installed or loaded as a task/procedure/overlay before it can be executed. Normal 
tagged object format is generally transportable between 990 computer systems and can be linked 
again if generated using a PARTIAL command. Normal tagged object is the default value for the 
FORMAT command. 

6.7.2 Compressed Tagged Object 

This format is a condensed version of the normal tagged object and can only be output to a file 
that supports binary data. Except for this, compressed object is treated as normal tagged object. 
Compressed object results in a savings of disk space as compared to the normal tagged format. 
The difference between compressed and normal object is that in compressed the numeric fields 
are expressed in binary instead of ASCII. Also, in compressed format, the binary 01 is used 
instead of tag 0. 

6.7.3 Memory Image Format 

Memory image format appears exactly as the program appears in memory and is loaded directly 
to a DNOS Program File or a DNOS Image File. 

When the IMAGE format is selected, the user may enter the REPLACE parameter which causes 
the new procedures, tasks, or overlays to replace existing ones of the same name, in the program 
file (defined by the LINKED OUTPUT ACCESS NAME). The task execution priority is defined by the 
priority parameters (1,2,3 or 4). The default priority value is 4. 

In DNOS, the IMAGE format can also be used to install the Linked Output on an Image File, a 
unique file type containing the loadable image for the loader. It is used for the Initial Program 
Load. Refer to following paragraphs on installing the Image file with the Link Editor. 

The Link Editor cannot be used to install memory-resident, system, or privileged tasks on a 
program file. These tasks must be installed using the Install Task SVC, or the Install Task (IT) 
command. 
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6.8 INSTALLING A LINKED PROGRAM 


Under DNOS, programs are called tasks. A task may be segmented to include sharable pro- 
cedures and may also include overlays. After link edit, and before program execution, the task and 
its procedures and overlays must be installed on a program file (unless this step is bypassed by 
use of thp IMAGE format option of the Link Editor). Either the system program file or a program 
file created by the Create Program File (CFPRO) command may be used to install the task. To 
create the program file, .USER.PROGA for the example program, enter CFPRO and press 
RETURN. Enter the responses displayed below: 


[] CFPRO 


CREATE PROGRAM FILE 

PATHNAME 
MAX NUMBER OF TASKS 
MAX NUMBER OF PROCEDURES 
MAX NUMBER OF OVERLAYS 
INITIAL ALLOCATION 
SECONDARY ALLOCATION 
EXPANDABLE? 


.USER.PROGA 

255 

255 

255 

85 

YES 


All of the install commands in this section allow the program file and the object file to be 
specified by file name or by LUNO. The manner in which the program file is selected is arbitrary. 
There is an important difference between selecting the object file by LUNO and selecting the 
object file by pathname. Files specified by pathname are rewound when opened, but files 
specified by LUNO are not rewound when opened. Therefore, if the same object file contains pro- 
cedures, tasks, and overlays, it must be specified by LUNO for the commands to correctly install 
all of the object code in a program. 

Procedures, tasks and overlays must be installed in the following order: 

1. Procedures, if any, must be installed first. 

2. The task is installed after the procedures. 

3. Overlays are installed last. 

Thus, object files containing more than one object (procedure, task, overlay) must be ordered with 
the procedures first, task second, and overlays last. 

To install object files, enter the installation commands necessary and answer the prompts (press- 
ing the RETURN key after each response). 

Do not install a task on the S$UTIL file. Use the program file .S$SHARED to install shared pro- 
cedures. The .S$SHARED program file is used as the default program file for a bid with no LUNO 
specified. It is recommended that you install tasks in your own program file. This recommenda- 
tion also applies to installing real-time tasks, procedures, and overlays. 

The following paragraphs discuss the commands which instail, delete, and modify programs. For 
complete command descriptions, refer to the DNOS System Command Interpreter (SCI) 
Reference Manual. 
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Installing or modifying a task or procedure to be memory resident requires an Initial Program Load 
(IPL) be performed before the task or procedure is in memory. 

6.8.1 Install Task Segment — IT 

The IT command places an executable task on a program file. If the task has attached procedures, 
the procedures must be installed before the IT command. For an explanation of the task attributes 
(priority, privileged, system, memory resident, and replicatable) consult Section 3. 

The IT command and prompts are described below: 

Prompts: 


INSTALL TASK SEGMENT 

PROGRAM FILE OR LUNO: {filename®/integer} (*) 

TASK NAME: [alphanumeric] 

TASK ID: [integer] 

OBJECT PATHNAME OR LUNO: {pathname@/integer} (*) 

PRIORITY: [integer] (4) 

DEFAULT TASK FLAGS?: YES/NO (YES) 

ATTACHED PROCEDURES?: YES/NO (NO) 


If the response to the DEFAULT TASKS FLAGS?: prompt was NO, the following sets of prompts 
are displayed on the user’s terminal: 


DEFINE TASK FLAGS 

PRIVILEGED?: YES/NO (NO) 

SYSTEM TASK?: YES/NO (NO) 

MEMORY RESIDENT?: YES/NO (NO) 

REPLICATABLE?: YES/NO (YES) 

DELETE PROTECT?: YES/NO (NO) 

IN MEMORY COPYABLE?: YES/NO (NO) 

IN MEMORY REUSABLE?: YES/NO (NO) 

UPDATABLE?: YES/NO (NO) 

SOFTWARE PRIVILEGED?: YES/NO (NO) 


After the responses to the previous prompts are entered, the following prompts are displayed on 
the user’s terminal: 


990/12 FLAGS 


EXECUTE PROTECT?: 

YES/NO 

(NO) 

OVERFLOW CHECKING?: 

YES/NO 

(NO) 

WRITABLE CONTROL STORAGE?: 

YES/NO 

(NO) 


If the response to the ATTACHED PROCEDURES: prompt was YES, the following set of prompts is 
displayed on the user’s terminal: 

ATTACH TASK PROCEDURES 

1ST PROCEDURE ID: integer (0) 

PI FROM TASKS PROGRAM FILE?: [YES/NO] (YES) 

2ND PROCEDURE ID: [integer] (0) 

P2 FROM TASKS PROGRAM FILE?: [YES/NO] (YES) 
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Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of or the LUNO assigned to the program file on which the task segment is to be 
installed. If a LUNO is specified in response to this prompt, it must be assigned to the pro- 
gram file prior to the execution of the IT command. If zero is specified, the .S$SHARED pro- 
gram file is assumed. 

TASK NAME: 

A user-defined character string, up to eight ASCII characters, which is the name of the task 
segment to be installed on the specified program file. If zero or a null response is specified, 
the system will assign the IDT name of the object module as the task segment name. 

TASK ID; 

A hexadecimal value which will be associated with the installed task segment. If zero or a 
null response is specified, the system assigns an available ID. 

OBJECT PATHNAME OR LUNO: 

The pathname of or the LUNO assigned to a device or file where the object module of the 
task segment resides. 

PRIORITY: 

The integer value which represents the execution priority level of the task. Priorities may 
range from zero through four. Priorities zero through three are fixed, with priority zero as the 
highest level and three the lowest. Priority four is dynamically managed by the operating 
system. Four is the default priority level. 

DEFAULT TASK FLAGS?: 

If NO is entered in response to this prompt, the user has the option to set the task flags. If 
YES is entered, the initial values are used for the flags. 

PRIVILEGED?: 

If YES is entered, the task is allowed to execute privileged hardware instructions. Privileged 
hardware instructions should be executed cautiously and only by the user who is very 
familiar with the system. 

SYSTEM TASK?: 

If YES is entered, the task is allowed to execute In system memory space. Tasks should be 
executed in system memory space with caution and only by the user who is very familiar with 
the system. 

MEMORY RESIDENT?: 

If YES is entered, and the task Is installed on the program file .S$SHARED of the applications 
program file specified at system generation the task will be loaded into memory during initial 
program load (IPL) and remain in memory when terminated. 

REPLICATABLE?; 

If YES is entered, there may be multiple copies of the task in memory simultaneously. 
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DELETE PROTECT?: 

If YES is entered, the task segment cannot be deleted from the program file unless the 
Modify Task Segment Entry (MTE) command is used to unprotect the task segment prior to 
the execution of the Delete Task Segment (DT) command. If NO is specified, the task seg- 
ment may be deleted by the DT command. 

IN MEMORY COPYABLE?: 

If YES is entered, the task segment may be copied from memory rather than being copied 
from disk. This situation may occur if the task is in memory, and another user wishes to ex- 
ecute the task. 

IN MEMORY REUSABLE?: 

If YES is entered, the task segment memory may be reused by another task rather than being 
copied from disk or from one memory location to another. 

UPDATABLE?: 

If YES is entered, the data of a task may be modified, and the task segment wili be written to 
disk with the new data modifications when the task terminates. 

SOFTWARE PRIVILEGED?: 

If YES is entered, the task is aliowed to execute priviieged supervisor calls. 

EXECUTE PROTECT?: 

If YES is entered, execution of the task segment is prohibited. The protection is enforced on- 
iy on a 990/12 computer. 

OVERFLOW CHECKING?: 

If YES is entered, the occurrence of arithmetic overflow will cause control of the task to pass 
to the task’s end action routine. Overflow checking is enforced only on a 990/12 computer. 

WRITABLE CONTROL STORAGE?: 

If YES is entered, the task uses the writable control storage area. Writable control storage is 
available only on a 990/12 computer. 

ATTACHED PROCEDURES?: 

If YES is entered in response to this prompt, the user will be prompted for the ID(s) of pro- 
cedure segments attached to this task segment and asked if the procedures reside on the 
same program file as the task. 

1ST PROCEDURE ID: 

The integer value representing the ID of a procedure attached to the task segment. If zero is 
entered, there are no procedures. 

PI FROM TASKS PROGRAM FILE?: 

If YES is entered, the attached procedure segment whose ID was specified for the 1ST PRO- 
CEDURE ID: prompt resides on the same program file as the task segment. If NO is entered, 
that procedure segment must reside on the .S$SHARED program file. 

2ND PROCEDURE ID: 

The integer value representing the ID of a procedure segment attached to the task segment. 
If zero is entered, there is no 2nd procedure. 
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P2 FROM TASKS PROGRAM FILE?: 

If YES is entered, the attached procedure segment whose ID was specified for the 2ND PRO- 
CEDURE ID: prompt resides on the same program file as the task. If NO is entered, that pro- 
cedure segment must reside on the .S$SHARED program file. 

6.8.2 Install Real-Time Task Segment — IRT 

The IRT command places an executable real-time task on a program file. If the task has attached 
procedures, the procedures must be installed before the IRT command. For an explanation of the 
task attributes (priority, privileged, system, memory resident, and replicative) consult Section 3. 
The previously mentioned restrictions on installing tasks also apply to installing real-time tasks. 
The prompts for installing a real-time task are similar to the IT command and are described in the 
paragraph on installing a task. 

Prompts: 

INSTALL REAL-TIME TASK SEGMENT 

PROGRAM FILE OR LUNO: {filename@/integer} (*) 

TASK NAME: [alphanumeric] 

TASK ID: [integer] 

OBJECT PATHNAME OR LUNO: {pathname@/integer} (*) 

PRIORITY: integer 

DEFAULT TASK FLAGS?: YES/NO (YES) 

ATTACHED PROCEDURES?: YES/NO (NO) 

If the response to the DEFAULT TASKS FLAGS?: prompt was NO, the following prompts are 
displayed on the user’s terminal: 

DEFINE TASK FLAGS 


PRIVILEGED? 

YES/NO 

(NO) 

SYSTEM TASK? 

YES/NO 

(NO) 

MEMORY RESIDENT? 

YES/NO 

(NO) 

REPLICATABLE? 

YES/NO 

(YES) 

DELETE PROTECT? 

YES/NO 

(NO) 

IN MEMORY COPYABLE? 

YES/NO 

(NO) 

IN MEMORY REUSABLE? 

YES/NO 

(NO) 

UPDATABLE? 

YES/NO 

(NO) 

SOFTWARE PRIVILEGED? 

YES/NO 

(NO) 


After the responses are entered for the previous prompts, the following prompts are displayed on 
the user’s terminal: 


990/12 FLAGS 


EXECUTE PROTECT?: 

YES/NO 

(NO) 

OVERFLOW CHECKING?; 

YES/NO 

(NO) 

WRITABLE CONTROL STORAGE?: 

YES/NO 

(NO) 
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If the response to the ATTACHED PROCEDURES: prompt was YES, the following prompts are 
displayed on the user’s terminal: 

ATTACH TASK PROCEDURES 


1ST PROCEDURE ID: 

integer 

(0) 

PI FROM TASKS PROGRAM FILE?: 

[YES/NO] 

(YES) 

2ND PROCEDURE ID: 

[integer] 

(0) 

P2 FROM TASKS PROGRAM FILE?: 

[YES/NO] 

(YES) 


Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name or the LUNO assigned to the program file on which the task segment is to be 
installed. If a LUNO is specified in response to this prompt, it must be assigned to the pro- 
gram file prior to execution of the IRT command. If zero is specified, the .S$SHARED pro- 
gram file is assumed. 

TASK NAME: 

A user-defined character string, up to eight ACSIl characters, which is the name of the task 
segment to be installed on the specified program file. If zero or a null response is entered, 
the system assigns the IDT name of the object module as the name of the task segment. 

TASK ID: 

A hexadecimal value which will be associated with the installed task segment. If the 
response to this prompt is zero or a null response is entered, the system assigns an available 
ID. 

OBJECT PATHNAME OR LUNO: 

The pathname of or the LUNO assigned to the device or file where the object module for the 
task segment resides. 

PRIORITY: 

The integer value which represents the execution priority level of the task segment. Priorities 
may range from 1 through 127, with 1 being the highest priority. 

DEFAULT TASK FLAGS?: 

If NO is entered in response to this prompt, the user has the option to set the task flags. If 
YES is entered, the initial values are used for the flags. 

PRIVILEGED?: 

If YES is entered, the task is allowed to execute privileged hardware instructions. Privileged 
hardware instructions should be executed cautiously and only by the user who is very 
familiar with the system. 

SYSTEM TASK?: 

If YES is entered, the task is allowed to execute in system memory space. Tasks should be 
executed in system memory space with caution and only by the user who is very familiar with 
the system. 
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MEMORY RESIDENT?: 

If YES is entered, and the task is installed on the program file .S$SHARED or the application 
program file specified at system generation, the task will be loaded into memory during in- 
itial program load (IPL) and remain in memory when terminated. 

REPLICATABLE?: 

If YES is entered, there may be multiple copies of the task in memory simultaneously. 
DELETE PROTECT?: 

If YES is entered, the task segment cannot be deleted from the program file unless the 
Modify Task Segment Entry (MTE) command is used to unprotect the task segment prior to 
the execution of the Delete Task Segment (DT) command. If NO is specified, the task seg- 
ment may be deleted by executing the DT command. 

IN MEMORY COPYABLE?: 

If YES is entered, the task segment may be copied from memory rather than being copied 
from disk. This situation may occur if the task is in memory and another user wishes to 
execute the task. 

IN MEMORY REUSABLE?: 

If YES is entered, the task segment memory may be reused by another task rather than being 
copied from disk or from one memory location to another. 

UPDATABLE?: 

If YES is entered, the data of the task segment may be modified, and the task segment will be 
written to disk with the new data modifications after the task terminates. 

SOFTWARE PRiViLEGED?: 

If YES is entered, the task is allowed to execute privileged supervisor calls. Privileged super- 
visor calls should be executed cautiously and only by the user who is very familiar with the 
system. 

EXECUTE PROTECT?: 

If YES is entered, execution of the task is prohibited. The protection is enforced only on a 
990/12 computer. 

OVERFLOW CHECKING?: 

If YES is entered, the occurrence of arithmetic overflow causes control of the task to pass to 
the task’s end action routine. Overflow checking is available only on a 990/12 computer. 

WRITABLE CONTROL STORAGE?: 

If YES is entered, the task uses the writable control storage area. Writable control storage is 
available only on a 990/12 computer. 

ATTACHED PROCEDURES?: 

If YES is entered in response to this prompt, the user will be prompted for the ID(s) of pro- 
cedure segments attached to this task segment and asked if the procedures reside on the 
same program file as the task. 

1ST PROCEDURE ID: 

The integer value representing the ID of a procedure segment attached to the task segment. 
If zero is entered, there are no procedures. 
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P1 FROM TASKS PROGRAM FILE?: 

If YES is entered, the attached procedure segment whose ID was specified for the 1ST PRO- 
CEDURE ID: prompt resides on the same program file as the task segment. If NO is entered, 
that procedure segment must reside on the .S$SHARED program file. 

2ND PROCEDURE ID: 

The integer value representing the ID of a procedure segment attached to the task segment. 
If zero is entered, there is no 2nd procedure segment. 

P2 FROM TASKS PROGRAM FILE?: 

If YES is entered, the attached procedure segment whose ID was specified for the 2ND PRO- 
CEDURE ID: prompt resides on the same program file as the task segment. If NO is entered, 
that procedure segment must reside on the .S$SHARED program fiie. 


6.8.3 Install Procedure Segment -- IP 

The IP command places a procedure on a program file and assigns a procedure ID for use by 
subsequent IT commands. The previously mentioned restrictions on installing tasks also apply to 
installing procedures. The IP command and prompts are described below: 

Prompts: 


INSTALL PROCEDURE SEGMENT 

PROGRAM FILE OR LUNO: {filename@/integer} (*) 

PROCEDURE NAME: [alphanumeric] 

PROCEDURE ID: [integer] 

OBJECT PATHNAME OR LUNO: {pathname@/integer} (*) 

MEMORY RESIDENT?: YES/NO (NO) 

DELETE PROTECT?: YES/NO (NO) 


After responses are entered for the previous prompts, the following prompts are displayed on the 
user’s terminal: 

990/12 FLAGS 


EXECUTE PROTECT?: 

YES/NO 

(NO) 

WRITE PROTECT?: 

YES/NO 

(NO) 

WRITABLE CONTROL STORAGE?: 

YES/NO 

(NO) 


Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of, or the LUNO assigned to, the program file on which the procedure segment 
is to be installed. If a LUNO is specified in response to this prompt, it must be assigned to 
the program file prior to execution of the IP command. If zero is specified, the .S$SHARED 
program file is assumed. 

PROCEDURE NAME: 

A user-defined character string, up to eight characters, that identifies the procedure seg- 
ment. If the procedure name is not specified, the system will assign the IDT name of the 
object module as the procedure name. 
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PROCEDURE ID: 

A hexadecimal integer that will be assigned as the ID of the procedure segment. If zero or a 
null response is specified, the system assigns an ID. 

OBJECT PATHNAME OR LUNO: 

Ihe name of, or the LUNO assigned to, a device or file where the object module for the pro- 
cedure segment resides. 

MEMORY RESIDENT?: 

If YES is entered, and the procedure segment is installed on the program file .S$SHARED or 
the applications program file specified at system generation, the procedure segment will be 
loaded into memory during initial pr.og ram load (IPL) and will stay in memory even when 
terminated. 


DELETE PROTECT?: 

If YES is entered, the procedure segment cannot be deleted from the program file unless the 
Modify Procedure Segment Entry (MPE) command is used to unprotect the procedure seg- 
ment prior to the execution of the Delete Procedure Segment (DP) command, if NO is 
specified, the procedure segment may be deleted by executing the DP command. 


EXECUTE PROTECT?: 

If YES is entered, the procedure segment cannot be executed. The protection is enforced 
only on a 990/12 computer. 

WRITE PROTECT?: 

If YES is entered, the procedure segment cannot be modified when in memory. The protec- 
tion is enforced only on a 990/12 computer. 

WRITABLE CONTROL STORAGE?: 

If YES Is entered, the procedure segment uses the writable control storage area. Writable 
control storage is available only on a 990/12 computer. 

6.8.4 Install Overlay — 10 

The 10 command places an overlay associated with a task on the program file with the task. The 
task must be installed before the overlay and may be specified by name or installed ID. The 
previously mentioned restrictions on installing tasks also apply to installing real-time tasks. The 
10 command and prompts are described below: 

Prompts: 


INSTALL OVERLAY 

PROGRAM FILE OR LUNO 
OVERLAY NAME 
OVERLAY ID 
OBJECT PATHNAME OR LUNO 
RELOCATABLE? 
DELETE PROTECT? 
ASSOCIATED TASK NAME OR ID 


{filename@/integer} 

(*) 

[alphanumeric] 


[integer] 


{pathname ©/integer} 

(*) 

YES/NO 

(NO) 

YES/NO 

(NO) 

[{character(s)/integer}] 

n 
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Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of, or LUNO assigned to, the program fiie on which the overiay is to be instalied. 
If a LUNO is specified in response to this prompt, it must be assigned to the program fiie 
prior to the execution of the iO command. If zero is specified, the .S$SHARED program fiie is 
assumed. 

OVERLAY NAME: 

A user-defined character string, a maximum of eight characters, that is unique to the pro- 
gram fiie. If a null response Is specified, the system uses the IDT name of the object module 
as the name of the overlay. 

OVERLAY ID: 

An integer vaiue in the range of 1 through 255 that is associated with the overiay name and is 
unique to the program fiie. If zero or a null response is specified, the system wiii assign an ID 
to the overlay. 

OBJECT PATHNAME OR LUNO: 

The name of, or the LUNO assigned to, the device or fiie where the object module for the 
overlay resides. 

RELOCATABLE?: 

If YES is entered, the overiay is aliowed to be loaded at an address other than its natural load 
address. 

DELETE PROTECT?: 

If YES is entered, the overiay cannot be deleted from the program file unless the Modify 
Overlay Entry (MOE) command is used to unprotect the overlay prior to the execution of the 
Deiete Overiay (DO) command. If NO is specified, the overiay may be deieted by executing 
the DO command. 


ASSOCIATED TASK NAME OR ID: 

The name or ID of a previously Installed task segment on the same program file as the 
overlay. The overlay is automaticaily deieted when the task segment is deieted. 

6.8.5 Install Program Segment — IPS 

The IPS command allows the user to Install a segment on a program file and assign a segment ID. 
The IPS command and prompts are described below: 


Prompts: 


INSTALL PROGRAM SEGMENT 
PROGRAM FILE OR LUNO 
SEGMENT NAME 
SEGMENT ID 
OBJECT PATHNAME OR LUNO 
DEFAULT SEGMENT FLAGS? 


{filename@/integer} 

[alphanumeric] 

[integer] 

(pathname ©/integer} 
YES/NO 


(*) 

(YES) 
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If the response to the DEFAULT SEGMENT FLAGS?: prompt is NO, the following set of prompts is 
displayed on the user’s terminal: 

DEFINE SEGMENT FLAGS 


SYSTEM SEGMENT? 

YES/NO 

(NO) 

MEMORY RESIDENT? 

YES/NO 

(NO) 

DELETE PROTECT? 

YES/NO 

(NO) 

UPDATABLE? 

YES/NO 

(NO) 

SHARABLE? 

YES/NO 

(NO) 

REPLICATABLE? 

YES/NO 

(NO) 

IN MEMORY REUSABLE? 

YES/NO 

(NO) 

IN MEMORY COPYABLE? 

YES/NO 

(NO) 


After the responses are entered for the previous prompts, the following prompts are displayed on 
the user’s terminal: 

990/12 FLAGS 


EXECUTE PROTECT?: 

YES/NO 

(NO) 

WRITE PROTECT?: 

YES/NO 

(NO) 

WRITABLE CONTROL STORAGE?: 

YES/NO 

(NO) 


Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of, or the LUNO assigned to, the program file on which the program segment is 
to be installed. If a LUNO is specified in response to this prompt, it must be assigned to the 
program file prior to execution of the IPS command. If zero is specified, the .S$SHARED pro- 
gram file is assumed. 

SEGMENT NAME: 

A user-defined character string, up to eight characters, composed of characters which are 
legal in pathnames. The segment name must be unique to the specified program file. If zero 
or a null response is specified, the IDT name of the object file will be used as the segment 
name. 

SEGMENT ID: 

A hexadecimal integer value that will be assigned as the ID of the program segment by the 
user. If zero or a null response is specified, the system will assign the ID. 

OBJECT PATHNAME OR LUNO: 

The pathname of, or the LUNO assigned to, the device or file where the object module for the 
program segment resides. 

DEFAULT SEGMENT FLAGS?: 

If YES is entered, the initial values are used for the flags. If NO is entered, the user has the 
option of which program segment flags will be modified. 

SYSTEM SEGMENT?: 

If YES is entered, the program segment may only be accessed by a system task. 
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MEMORY RESIDENT?: 

If YES is entered, and the program segment is installed on the program file .S$SHARED or 
the applications program file specified at system generation, the program segment will be 
loaded into memory during initial program load (IPL) and remain in memory even when ter- 
minated. 

DELETE PROTECT?: 

If YES is entered, the program segment cannot be deleted from the program file unless the 
Modify Program Segment Entry (MSE) command is used to unprotect the program segment 
prior to the execution of the Delete Program Segment (DPS) command. If NO is specified, the 
program segment may be deleted by executing the DPS command. 

UPDATABLE?: 

If YES is entered, the data of a program segment may be modified, and the program segment 
will be written to disk with the new data modifications after the program segment is no 
longer used. 

SHARABLE?: 

If YES is entered, the program segment may be shared concurrently with more than one task. 
REPLICATABLE?: 

If YES is entered, there may be multiple copies of the program segment in memory 
simultaneously. 

IN MEMORY REUSABLE?: 

If YES is entered, the program segment in memory may be reused after termination by 
another task rather than a new copy being read from disk. 

IN MEMORY COPYABLE?: 

If YES is entered, the program segment may be copied from memory rather than being copied 
from disk. This situation may occur when the program segment is in memory and another 
user wishes to use the program segment. 

EXECUTE PROTECT?: 

If YES is entered, execution of the program segment is prohibited. The protection is enforced 
only on a 990/12 computer. 

WRITE PROTECT?: 

If YES is entered, the program segment may not be modified in memory. The protection is 
enforced only on a 990/12 computer. 

WRITABLE CONTROL STORAGE?: 

If YES is entered, the program segment uses the writable control storage area. Writable con- 
trol storage is available only on a 990/12 computer. 


j 
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6.8.6 Delete Task — DT 

The DT command removes a previously installed task from a program file. The task may be 
deleted by either name or by installed ID. If associated overlays exist, they are also deleted. The 
task may be specified by name or by installed ID, as shown below; 

Prompts: 

DELETE TASK SEGMENT 

PROGRAM FILE OR LUNO: {filename@/integer} (*) 

TASK NAME OR ID: {alphanumeric/integer} 

Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of, or LUNO assigned to, the program file on which the task segment has been 
installed. If a LUNO is specified in response to this prompt, it must be assigned to the pro- 
gram file prior to execution of the DT command. 

TASK NAME OR ID: 

The name or ID of the task segment on the specified program file. 

6.8.7 Delete Procedure — DP 

The DP command removes a previously installed procedure from a program file. The procedure 
may be specified by name or by installed ID, as shown below: 

Prompts: 

DELETE PROCEDURE SEGMENT 

PROGRAM FILE OR LUNO: {filename@/integer} (*) 

PROCEDURE NAME OR ID: {alphanumeric/integer} 

Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of, or the LUNO assigned to, the program file in which the procedure segment 
has been installed. If a LUNO is specified in response to this prompt, it must be assigned to 
the program file prior to execution of the DP command. 

PROCEDURE NAME OR ID: 

The name or ID of the procedure segment to be deleted from the specified program file. 

6.8.8 Delete Overlay — DO 

The DO command removes a previously installed overlay from a program file. The overlay may be 
specified by name or by installed ID, as shown below: 

Prompts: 

DELETE OVERLAY 

PROGRAM FILE OR LUNO: {filename@/integer} (*) 

OVERLAY NAME OR ID: {alphanumeric/integer} 
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Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of, or the LUNO assigned to, the program file on which the overlay has been 
installed. If a LUNO is specified in response to this prompt, it must be assigned to the pro- 
gram fiie prior to execution of the DO command. 

OVERLAY NAME OR ID: 

The name or ID of the overlay installed on the specified program file that is to be deleted. 

6.8.9 Delete Program Segment — DPS 

The DPS command is used to delete a segment from a specified program fiie. The program seg- 
ment may be specified by name or be installed ID, as shown below: 

Prompts: 

DELETE PROGRAM SEGMENT 

PROGRAM FILE OR LUNO: {filename@/integer} {*) 

SEGMENT NAME OR ID: {alphanumeric/integer} 

Prompt Details: 

PROGRAM FILE OR LUNO: 

The filename of, or the LUNO assigned to, the program file on which the program segment 
has been installed. If a LUNO is specified in response to this prompt, it must be assigned to 
the program file prior to execution of the DPS command. 

SEGMENT NAME OR ID: 

The name or ID by which the program segment is known on the specified program file. 


6.8.10 Modify Task Segment Entry — MTE 

The MTE command allows the user to alter the data supplied when the task was Installed. The 
values displayed are those defined during installation. Any of the displayed values may be 
changed, or the displayed value can be accepted by pressing the RETURN key. Refer to the IT 
command paragraph for the prompt descriptions for the task attributes. When the MTE command 
is called, the following appears: 

Prompts: 

MODIFY TASK SEGMENT ENTRY 
PROGRAM FILE PATHNAME: 

MODULE NAME OR ID: 


filename® (*) 

{alphanumeric/integer} 
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After the responses to the PROGRAM FILE PATHNAME: and MODULE NAME OR ID: prompts 
have been entered, the following set of prompts is displayed on the user’s terminal: 

MODIFY TASK ENTRY FOR ID <n> 


NAME: 

alphanumeric 

n 

REALTIME?: 

YES/NO 

(*) 

PRIORITY: 

integer 

(*) 

MODIFY FLAGS?: 

YES/NO 

(YES) 

ATTACHED PROCEDURES?: 

YES/NO 

(NO) 


where <n> is the iD of the task to be modified. (This ID is for user information only and may not be 
modified.) 

If YES was entered in response to the MODIFY FLAGS? prompt, the following prompts are 
displayed on the user’s terminal: 

MODIFY TASK FLAGS 


PRIVILEGED?: YES/NO (*) 

SYSTEM TASK?: YES/NO (*) 

MEMORY RESIDENT?: YES/NO (*) 

REPLICATABLE?: YES/NO (*) 

DELETE PROTECT?: YES/NO (*) 

IN MEMORY COPYABLE?: YES/NO (*) 

IN MEMORY REUSABLE?: YES/NO (*) 

UPDATABLE?: YES/NO (*) 

SOFTWARE PRIVILEGED?: YES/NO (*) 


After the responses to the previous prompts are entered, the following prompts are dispiayed on 
the user’s terminai: 


990/12 FLAGS 


EXECUTE PROTECT?: 

YES/NO 

(*) 

OVERFLOW CHECKING?: 

YES/NO 

(*) 

WRITABLE CONTROL STORAGE?: 

YES/NO 

(*) 


If the response to the ATTACHED PROCEDURES?: prompt was YES, the following set of prompts 
is displayed on the user’s terminal: 

MODIFY TASK-ATTACHED PROCEDURES 


1ST PROCEDURE ID: integer (*) 

PI FROM TASKS PROGRAM FILE?: YES/NO (*) 

2ND PROCEDURE ID: integer (*) 

P2 FROM TASKS PROGRAM FiLE?: YES/NO (*) 


Prompt Details: 

PROGRAM FILE PATHNAME: 

The file name of the program file on which the task segment to be modified has been 
instalied. 
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MODULE NAME OR ID; 

The task name or ID of the task segment installed on the specified program file. 

NAME: 

The name of the task. If the task ID was entered, the system automatically places the 
associated task name in the response field of this prompt. 

REALTIME?: 

If YES is entered, the task segment to be modified was installed as a real-time task segment. 
PRIORITY: 

If YES was entered in response to the REAL TIME?: prompt, the priority value specified must 
be in the range of 1 through 127 (inclusive). If NO was entered, the priority value specified 
must be in the range of 0 through 4 (inclusive). 

MODIFY FLAGS?: 

If YES is entered, the user has the option of modifying the task flags. 

PRIVILEGED?: 

If YES is entered, the task is allowed to execute privileged hardware instructions. Privileged 
hardware instructions should be executed cautiously and only by the user who is very 
familiar with the system. 

SYSTEM TASK?: 

If YES Is entered, the task is allowed to execute In system memory space. For the task to be 
modified to become a system task, the task’s load address must be greater than or equal to 
>0000. Tasks should be executed in system memory space with caution and only by the user 
who is very familiar with the system. 

MEMORY RESIDENT?: 

If YES is entered and the task is installed on the .S$SHARED program file or the applications 
program file specified at system generation, the task will be loaded into memory during 
initial program load (IPL) and remain in memory when terminated. 

REPLICATABLE?: 

If YES is entered, there may be multiple copies of the task in memory simultaneously. 
DELETE PROTECT?: 

If YES is entered, the task is protected against accidental deletion. 

IN MEMORY COPYABLE?: 

If YES is entered, the task segment may be copied from memory rather than being copied 
from disk. This situation may occur if the task is in memory and another user wishes to exe- 
cute the task. 

IN MEMORY REUSABLE?: 

If YES is entered, the program segment in memory may be reused after termination by 
another task, rather than a new copy being copied from disk or being copied from one 
memory location to another. 
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UPDATABLE?: 

If YES is entered, the data of a task may be modified, and the task segment will be written to 
disk with the new data modifications when the task terminates. 

SOFTWARE PRIVILEGED?: 

If YES Is entered, the task is allowed to execute privileged supervisor calls. Privileged super- 
visor calls should be executed with caution and only by the user who is very familiar with the 
system. 

EXECUTE PROTECT?: 

If YES is entered, execution of the task segment is prohibited. The protection is enforced 
only on a 990/12 computer. 

OVERFLOW CHECKING?: 

If YES is entered, the occurrence of arithmetic overflow will cause control of the task to pass 
to the task’s end-action routine. Overflow checking is available only on a 990/12 computer. 

WRITABLE CONTROL STORAGE?: 

If YES is entered, the task uses the writable control storage area. Writable control storage is 
available only on a 990/12 computer. 

ATTACHED PROCEDURES?: 

If YES is entered, the user has the option of modifying the procedures to be attached to the 
task segment. 

1ST PROCEDURE ID: 

The integer value representing the ID of a procedure segment attached to the task segment. 
If zero is entered, there are no procedure segments. 

PI FROM TASKS PROGRAM FILE?: 

If YES is entered, the attached procedure segment with an ID specified for the 1ST PRO- 
CEDURE ID: prompt resides on the same program file as the task segment. If NO is entered, 
the procedure segment must reside on the .S$SHARED program file. 

2ND PROCEDURE ID: 

The integer value representing the ID of a procedure segment attached to the task segment. 
If zero is entered, there is no 2nd procedure segment. 

P2 FROM TASKS PROGRAM FILE?: 

If YES is entered, the attached procedure segment with an ID specified for the 2ND PRO- 
CEDURE ID: prompt resides on the same program file as the task segment. If NO is entered, 
the procedure segment must reside on the .S$SHARED program file. 
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6.8.11 Modify Procedure Entry — MPE 

The MPE command allows the user to modify the data supplied when the procedure was installed. 
The values displayed are those defined when the procedure was installed. Any of the displayed 
values may be changed, or the displayed value can be accepted by pressing the RETURN key. 
When the MPE command is called, the following appears: 

Prompts: 

MODIFY PROCEDURE SEGMENT ENTRY 

PROGRAM FILE PATHNAME: filename® (*) 

MODULE NAME OR ID: {alphanumeric/integer} 

After the responses to the PROGRAM FILE PATHNAME and MODULE NAME OR ID prompts have 
been entered, the following set of prompts are displayed on the user’s terminal: 

MODIFY PROCEDURE ENTRY FOR ID <n> 


NAME: 

alphanumeric 

(*) 

MEMORY RESIDENT?: 

YES/NO 

D 

DELETE PROTECT?: 

YES/NO 

(*) 


where <n> is the ID of the procedure to be modified. (This ID is for user information only and may 
not be modified.) 

After the responses to the above prompts are entered, the following prompts are displayed on the 
user’s terminal: 

990/12 FLAGS 


EXECUTE PROTECT?: 

YES/NO 

{*) 

WRiTE PROTECT?: 

YES/NO 

(*) 

WRiTABLE CONTROL STORAGE?: 

YES/NO 

(*) 


Prompt Details: 

PROGRAM FILE PATHNAME: 

The file name of the program file where the procedure segment to be modified has been 
installed. 

MODULE NAME OR ID: 

The procedure name or ID of the procedure segment installed on the specified program file. 
NAME: 

The name of the procedure segment. If the procedure ID was entered, the system auto- 
matically places the associated procedure name in the response field of this prompt. 

MEMORY RESIDENT?: 

If YES is entered, and the procedure segment is installed on the program file .S$SHARED or 
the applications program file specified at system generation, the procedure segment will be 
loaded into memory during initial program load (IPL) and remain in memory even when 
terminated. 
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DELETE PROTECT?: 

If YES is entered, the procedure segment is protected against accidental deletion. 
EXECUTE PROTECT?; 

If YES is entered, execution of the procedure segment is prohibited. The protection is 
enforced only on a 990/12 computer. 

WRITE PROTECT?; 

If YES is entered, procedure data cannot be modified in memory. The protection is enforced 
only on a 990/12 computer. 

WRITABLE CONTROL STORAGE?: 

If YES is entered, the procedure uses the writable control storage area. Writable control 
storage is available only on a 990/12 computer. 

6.8.12 Modify Overlay Entry — MOE 

The MOE command allows the user to alter the data supplied when the overlay was installed. The 
values defined when the overlay was installed are displayed. Any of the entries may be changed, 
or the displayed value may be accepted by pressing the RETURN key. When the MOE command is 
called, the following appears: 

Prompts: 

MODIFY OVERLAY ENTRY 

PROGRAM FILE PATHNAME: filename® (*) 

MODULE NAME OR ID: {alphanumeric/integer} 

After the responses to the previous prompts have been entered, the following prompts are 
displayed on the user’s terminal: 

MODIFY OVERLAY ENTRY FOR ID <n> 


NAME: 

alphanumeric 

(*) 

RELOCATABLE?: 

YES/NO 

(*) 

DELETE PROTECT?: 

YES/NO 

(*) 


where <n> is the iD of the overlay to be modified. (This ID is for user information only and may not 
be modified.) 

Prompt Details: 

PROGRAM FILE PATHNAME: 

The file name of the program file on which the overlay is installed. 

MODULE NAME OR ID: 

The overlay name or ID of the overlay installed on the specified program file. 

NAME: 

The name of the overlay. If the overlay ID was entered, the system automatically places the 
associated overlay name in the response field of this prompt. 
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RELOCATABLE?: 

If YES is entered, the overlay is allowed to be loaded at an address other than its natural load 
address. 

DELETE PROTECT?: 

If YES is entered, the overlay is protected against accidental deletion. 


6.8.13 Modify Segment Entry — MSE 

The MSE command allows the user to modify the attributes of a segment installed on a program 
file. The attribute values displayed are those defined when the segment was installed. Any of the 
displayed values may be changed, or the displayed values can be accepted by pressing the 
RETURN key. When the MSE command is called, the following appears: 

Prompts: 

MODIFY PROGRAM SEGMENT ENTRY 

PROGRAM FILE PATHNAME: filename® (*) 

MODULE NAME OR ID: {alphanumeric/integer} 

After the responses to the PROGRAM FILE PATHNAME: and MODULE NAME OR ID: prompts 
have been entered, the following set of prompts is displayed on the user’s terminal: 

MODIFY PROGRAM SEGMENT ENTRY FOR ID <n> 


NAME: alphanumeric {*) 

SYSTEM SEGMENT?: YES/NO (*) 

MEMORY RESIDENT?: YES/NO {*) 

DELETE PROTECT?: YES/NO {*) 

UPDATABLE?: YES/NO (*) 

SHARABLE?: YES/NO (*) 

REPLICATABLE?: YES/NO (*) 

IN MEMORY REUSABLE?: YES/NO (*) 

IN MEMORY COPYABLE?: YES/NO (*) 


where <n> is the ID of the segment to be modified. (This ID is for user information only and may 
not be modified.) 

After the responses to the previous prompts are entered, the following prompts are displayed on 
the user’s terminal: 

990/12 FLAGS 


WRITE PROTECT?: 

YES/NO 

(*) 

EXECUTE PROTECT?: 

YES/NO 

(*) 

WRITABLE CONTROL STORAGE?: 

YES/NO 

n 


Prompt Details: 

PROGRAM FILE PATHNAME: 

The file name of the program file on which the program segment to be modified has been 
installed. 
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MODULE NAME OR ID; 

The segment name or ID of the program segment installed on the specified program file. 
NAME: 

The name of the program segment. If the segment ID was entered, the system automatically 
places the associated segment name in the response field of this prompt. 

SYSTEM SEGMENT?: 

If YES is entered, the program segment may only be accessed by a system task. 

MEMORY RESIDENT?; 

If YES is entered, and the program segment is installed on the program file .S$SHARED or the 
applications program file specified at system generation, the program segment will be loaded 
into memory during initial program load (IPL) and remain in memory even when terminated. 

DELETE PROTECT?: 

If YES is entered, the program segment Is protected against accidental deletion. 
UPDATABLE?: 

If YES is entered, the data of a program segment may be modified, and the program segment 
will be written to disk with the new data modifications after the task is terminated or if the 
task maps the program segment out of its addressable memory area. 

SHARABLE?; 

If YES is entered, the program segment may be shared concurrently with more than one task. 
REPLICATABLE?: 

If YES is entered, there may be multiple copies of the program segment in memory 
simultaneously. 

IN MEMORY REUSABLE?: 

If YES is entered, the program segment in memory may be reused after termination by 
another task; rather than a new copy being copied from disk or being copied from one 
memory location to another. 

IN MEMORY COPYABLE?: 

If YES Is entered, the program segment may be reused by copying the segment to more than 
one memory location rather than copying the segment from disk. 

WRITE PROTECT?: 

If YES Is entered, the program segment may not be modified. The protection is enforced only 
on a 990/12 computer. 

EXECUTE PROTECT?: 

If YES is entered, execution of the program segment is prohibited. The protection is enforced 
only on a 990/12 computer. 

WRITABLE CONTROL STORAGE?; 

If YES is entered, the program segment uses the writable control storage area. Writable con- 
trol storage is available only on a 990/12 computer. 
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S 


6.9 INSTALLING IMAGE FORMAT WITH LINK EDITOR 

The IMAGE format, selected by use of the FORMAT command, allows the Link Editor to install 
linked output memory images directly to a specified DNOS program file or to a DNOS image file. 
This feature allows the user to bypass the actual installation of tasks, procedures, and overlays. 
Linked output programs can replace existing programs or they can be added to the file. When the 
IMAGE format is selected and the overlays, tasks, and procedures are installed on a program file, 
the identifiers (IDs) of these overlays, tasks, and procedures are automatically assigned by the 
system. The assigned ID appears on the Load Map for the appropriate procedure, task, or phase. 
In order to load an overlay using a Load Overlay SVC, reference the overlay by name in the calling 
program, as shown: 

REF overlay name 

DATA overlay name 

The Link Editor resolves the reference and stores the assigned overlay ID as the DATA statement 
operand. The ID may then be used in the supervisor call block. 


NOTE 

If the task name matches the overlay name, the task ID is stored in j 

the DATA statement. 
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7.1 INTRODUCTION 

Many commands are provided to execute tasks. Three of these commands are used for assembly 
language tasks, while the others are used for executing tasks of the various language processors 
available for the 990 computer. 


7.2 EXECUTING AN ASSEMBLY LANGUAGE TASK 

The three commands for executing assembly language tasks each serve a particular function. 
These commands are described and their syntax given in the following paragraphs. 

7.2.1 Execute Task — XT 

The XT command is used to execute a task and to leave SCI active during task execution. This 
command is used for most tasks, except those being debugged and terminal interactive tasks. 

Prompts: 

EXECUTE TASK 


PROGRAM FILE OR LUNO: 

{fllename@/integer} 

(*) 

TASK NAME OR ID: 

{alphanumeric/integer} 

(*) 

PARM1: 

integer 

(0) 

PARM2: 

integer 

(0) 

STATION ID: 

{integer/ME} 

n 


Purpose: 

The XT command activates a program that does not interact with the user’s terminal. Two 
16-bit words of information can be passed to the program being activated in response to the 
PARM1 and PARM2 prompting messages of the XT command. The operating system 
automatically assigns a run-time ID to each program that it activates and displays the run- 
time ID at the user’s terminal upon successful activation of the program. A task activated by 
the XT command cannot access event characters entered at the user’s terminal. 

Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of or the LUNO assigned to the program file on which the task to be ex- 
ecuted has been installed. If a LUNO is specified in response to this prompt, it must be 
assigned prior to the execution of the XT command. If zero is specified, the .S$SHARED 
program file is assumed. 
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TASK NAME OR ID: 

Either the name or ID under which the program is installed on the specified program 
file. 

PARM1: and PARM2: 

Decimal or hexadecimal numbers in the range of 0 through 65535 representing a value 
to be passed to the program. 

STATION ID: 

The number (i.e., 2, not ST02) of the station with which the executing task is to be 
associated. A zero, or the characters ME indicates the user’s terminal. A >FF indicates 
the task is not to be associated with a station. 

A task should not be associated with a station unless it is used by the task for terminal 
I/O. If a station ID is specified through the XT command and SCI is quit (via the QUIT SCI 
command) before the task terminates, log on to SCI may not be performed until the task 
terminates. 

7.2.2 Execute Task and Suspend SCI ~ XTS 

The XTS command activates the specified task and suspends SCI until the task terminates. This 
command should be used for terminal interactive tasks to avoid contention between SCI and the 
task for terminal access. 

Prompts: 

EXECUTE TASK AND SUSPEND SCI 


PROGRAM FILE OR LUNO: 

{filename@/integer} 

(*) 

TASK NAME OR ID: 

{alphanumeric/integer} 

(*) 

PARM1: 

integer 

(0) 

PARM2: 

integer 

(0) 

STATION ID: 

{integer/ME} 

(*) 


Purpose: 

The XTS command activates an interactive program and automatically suspends SCI to pre- 
vent it from interfering with the execution of the program. If SCI were not suspended, it would 
continue to interpret data entered at the terminal as though that data were intended for SCI, 
and an error would result. This command Is also used to make event characters available to a 
task other than SCI. 

Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of or the LUNO assigned to the program file on which the task to be ex- 
ecuted has been installed. If a LUNO is specified in response to this prompt, it must be 
assigned prior to the execution of the XT command. If zero is specified, the .S$SHARED 
program file is assumed. 

TASK NAME OR ID: 

Either the name or ID under which the program is installed on the specified program 
file. 
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PARM1: and PARM2: 

Decimal or hexadecimal numbers in the range of 0 through 65535 representing a value 
to be passed to the program. 

STATION ID: 

The number (i.e., 2, not ST02) of the station with which the executing task is to be 
associated. A zero, or the characters ME indicates the user’s terminal. A >FF indicates 
the task is not to be associated with a station. 

A task should not be associated with a station unless it is used by the task for terminal 
I/O. If a station ID is specified through the XT command and SCI is quit (via the QUIT SCI 
command) before the task terminates, log on to SCI may not be performed until the task 
terminates. 

7.2.3 Execute and Halt Task — XHT 

The XHT command places a task in memory in a suspended state so that it can be debugged. 
Typically, the user places the task to be debugged in memory using XHT, establishes the debug 
environment (including breakpoints), and then activates the task using the Resume Task (RT) 


command. 

Prompts: 

EXECUTE AND HALT TASK 

PROGRAM FILE OR LUNO 

{filename@/integer} 

(*) 


TASK NAME OR ID 

{alphanumeric/integer} 

D 


PARM1 

integer 

(0) 


PARM2 

integer 

(0) 


STATION ID 

{integer/ME} 

(*) 


Purpose: 

The XHT command places a task in memory in a suspended state so that it can be debugged. 
Typically, the user places the task to be debugged in memory using XHT, establishes the 
debug environment (including breakpoints), and then activates the task using the Resume 
Task (RT) command. 

Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of or the LUNO assigned to the program file on which the task has been 
installed. If a LUNO is specified in response to this prompt, it must be assigned prior to 
the execution of the XHT command. If zero is specified, the .S$SHARED program file is 
used. 

TASK NAME OR ID: 

The name or the associated installed ID of the task whose execution is to be halted. 
PARM1: 

An integer value to be passed to the task being halted, determined by the programmer 
who wrote the task. 
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PARM2: 

A second integer value to be passed to the task being halted, determined by the 
programmer who wrote the task. 

STATION ID: 

The station ID (e.g., 1, 2) with which the task is to be associated or the two-character 
pseudo device name of ME. If >FF is entered, the task is not associated with any 
station. 


7.3 SVC EXECUTION OF TASK 

The Execute Task supervisor call is used to initiate the execution of a task installed on any pro- 
gram file. If the task specified in the call is already active and was defined as being replicatable 
(during installation), another copy of the task is placed in execution. The replicated task can share 
procedures with previous activations of the task. If the call is issued for a task that is active but is 
not replicatable, the system returns an error to the calling task. 

Refer to the DNOS Supervisor Call (SVC) Reference Manual for a complete description of the 
supervisor call block. 


7.4 BATCH STREAM AND INTERACTIVE EXECUTION ^ 

Execution of an assembly language task may also be performed in a batch stream. The batch 
command stream for executing a task is depicted in Figure 7-1. 

Refer to the section on assembling a program in this manual or the DNOS System Command 
Interpreter (SCI) Reference Manual for more information on batch stream operations. 


BATCH 

XT PR*. USER. PF. T*TEST1> PARM1*0> PARM2*0i S*ME 
EBATCH 


Figure 7-1. Execution Batch Stream 
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8.1 GENERAL INFORMATION 

Flaws in software are commonly called “bugs”. The process of removing flaws from software is 
called debugging. Modern programming techniques can drastically reduce the number of bugs in 
a program; however, the bugs which remain tend to be subtle and hard to find. DNOS provides 
several levels of debugging support, as follows: 

• Several System Command Interpreter (SCI) commands provide debugging capabilities 
without requiring a special mode of operation. 

• A special mode of operation allows a single task to be examined in detail during the 
execution process. 

Since all of the debug commands interact with the terminal, special care must be taken when 
debugging a program that uses the terminal, because two processes requesting terminal support 
can be confusing to the user. If the program being debugged requests use of a terminal, two ter- 
minals should be used: one for executing the program and one for debugging. 


8.2 MODES OF DEBUGGING 

There are two sets of debug commands: 

• Commands used for debugging alt tasks. 

• Controlled task commands used for tasks that have been put into the debug mode 
through the use of the Execute Debug (XD) command. 


NOTE 

Putting a task into debug mode affects the execution of all debug 

commands as follows: 

— Symbolic expressions may be used in place of integer expres- 
sions as responses to commands involving a controlled task. 

— Every command functions as if the controlled task is uncondi- 
tionally suspended. 

— Every command leaves the controlled task unconditionally 
suspended. 
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— Tasks which unconditionally suspend themselves can be 
momentarily reactivated by some of the debug commands. 

— The CMD key automatically suspends the controlled task 
when executing the Proceed from Breakpoint (PB), Deiete and 
Proceed from Breakpoint (DPB), or Resume Task (RT) com- 
mands. 


8.2.1 Unconditional Suspend 

Most of the debugging commands require that the task being debugged be unconditionally 
suspended either before or during the debug command. The “unconditional suspend’’ task state 
under DNOS (task state 6) is the state in which the task is dormant until activated by a command. 
There are severai ways for a task to become unconditionally suspended: 

• The task is bid with the suspend option selected. Either a supervisor cali, the Execute 
and Halt Task (XHT) command, or the .DBID SCI primitive suspend a task when the task 
is bid. 

The XHT command is used for tasks normally executed by an Execute Task (XT) com- 
mand. XHT places the task in a suspended state for debugging and dispiays the run iD 
of the task to the user. If the user desires to execute and halt the task, and 
simultaneously place it in controlled mode, the Execute Debug (XD) command may be 
used with no input for the RUN ID prompt. The XD command performs the XHT and 
saves the run ID as the default for the Debugger commands. 

The .DBID primitive is used for tasks that interface through SCI, such as command pro- 
cessors which are normaily bid using the .BID and .QBID primitives, described in the 
DNOS System Command Interpreter (SCI) Reference Manual. When the .DBID primitive 
is executed through SCI, the task Is bid and immediately placed in a suspended state. 
The run ID of the task is saved in the synonym $$BT or it may be obtained by issuing a 
Show Task Status (STS) command. 

• The task suspends itself. 

• The task executes a breakpoint (XOP 15,15). 

• The task is suspended by the SCI debug commands. 

Once the task has been placed in a suspended state, the Debugger may be used to assign break- 
points, simulate execution, display memory, and perform other debugging functions. When the 
debugging session is over, the task may be terminated by the Kill Task (KT) command. If the task 
was put into controlled mode by an XD command. It may be killed by responding YES to the KILL 
TASK? prompt of the Quit Debug (QD) command. 

8.2.2 Symbols 

The debug support provided allows symbolic debugging; whereby, the user can specify labels 
within the task being debugged rather than memory addresses. This method of debugging is both 
convenient and meaningful since the source code list can be used as reference for the symbolic 
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labels used. Symbolic constants consist of the link edit phase name, a period (.), the module iden- 
tifier name (IDT), a period (.), and the symbol, an assembly language label. The syntax is defined 
as: 


phase name.lDT name.symbol 


NOTE 

To have full symbolic capability, both the assembler and Link Editor 
must have used the SYMT option. 


If the assembler did not use the SYMT option, but the Link Editor did, then symbols of the follow- 
ing form are available: 

phase name.lDT name 

If either the phase name or the IDT name of a symbol is omitted, the immediately preceding phase 
name or IDT name is used. The syntax is as follows: 

.IDT name.symbol (no phase name) 

phase name.. symbol (no IDT name) 

..symbol (no phase or IDT name) 

Examples: 


PHASE1.MOD1.XYZ 

References Phase 

= 

PHASE1 


IDT 

= 

MODI 


Label 

= 

XYZ 

.MOD2.MNO 

References Phase 

— 

PHASE1 


IDT 

= 

MOD2 


Label 

= 

MNO 

..ABC 

References Phase 


PHASE1 


IDT 

= 

MOD2 


Label 

= 

ABC 


Four words of memory per symbol are required to store symbol values. 

If the task being debugged is a single routine installed without being linked, then the symbolic 
constant consists of a period (.), the characters of the module identifier name, a period (.), and the 
characters of the symbol, as follows: 

.IDT name.symbol 
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NOTE 

Symbols may only be used for commands affecting a task that has 
been placed in the debug mode by the Execute Debug (XD) command. 

Symbol encoding uses a hashing method which sometimes pro- 
duces a seeming duplication of values for a symbol. In such cases, 
use another symbol. 


8.2.3 Expressions 

Constants (and symbolic constants for tasks in the debug mode) may be combined using the 
operators + ), and <> to form expressions which may be used as command operands. 

The operators have the following meanings; 


Operator 


Meaning 


+ Unary pius or addition 

Unary minus or subtraction 
* Multiplication 

/ Division 

0 Evaluation order 

< > Indicated memory location contents 


NOTE 

The right angle bracket, >, is regarded as a hexadecimal number 
indicator rather than the right part of <> whenever there are hex- 
adecimal digits immediately following. Thus, no conflict arises. 


Expressions are evaluated according to the following rules: 

• Subexpressions delimited by ( ) and < > are evaluated first with the innermost expres- 
sion evaluated before any other levels. 

• Unless otherwise instructed by parentheses or angle brackets, unary -♦- and - are 
evaluated first, multiplication and division are evaluated second, and addition and sub- 
traction last. 

• For operators at the same level, evaluation proceeds left to right. 

• Arithmetic treats all constants as unsigned numbers. 
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For example, if .IDTNAM. BEGIN is memory address >7A, and if memory address >7F contains 
>3B, then the expression FF/{IDTN AM. BEGIN + 5 + -2 + 3*>F) is evaluated as follows: 

>FF/(<.IDTNAM. BEGIN + 5> + -2 + 3*>F) 

>FF/(<>7A + 5> + -2 + 3*>F) 

>FF/(<>7F> + -2 + 3*>F) 

>FF/{>3B + -2 + >2D) 

>FF/(>3B + (-2) + >2D) 

>FF/(>39 + >2D) 

>FF/>66 

2 

These symbols may be used In expression lists in the same way as constants or symbolic con- 
stants. For example, 

#PC + NAME.IDT - #R15 

is a valid expression. 

Several special symbols are allowed in expressions. These special symbols are; 

Symbol Description 

#PC Contents of the Program Counter 

#\NP Contents of the Workspace Pointer 

#ST Contents of the Status Register 

#Rn Contents of the Workspace Register whose number 

corresponds to the number (0 through 15) given for n. 

Character strings are also allowed in expressions. A character string is of the form ‘XXXX ’ 

where X is any valid ASCII character. The apostrophe can be represented in a character string by 
using double apostrophes. A character string may be any length, but only the leftmost four 
characters are significant. Strings shorter than four characters are right-justified with leading 
zeros. The value of a character string is an expression in the ASCII hexadecimal representation of 
the characters expressed as a 32-bit number. 


String 

Value 

’ABCD’ 

41424344 

’A’ 

00000041 

ABCDE’ 

41424244 

J 5 

00000020 

’A”B’ 

00412742 


8.3 COMMANDS FOR ALL TASKS 

The SCI commands described in the following paragraphs may be used for all tasks. These com- 
mands are most frequently used in debugging; however, may be used whenever SCI is active. 
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8 . 3.1 Debugging a Program 


Many of the debug commands require the run-time task ID returned by the XT or XHT commands. 
Make note of the run-time task ID when the task is placed in execution. The Show Task Status 
(STS) command may be used to identify the run-time ID (which identifies the task to DNOS). 

8.3.1 Data Display Commands 

These SCI commands display the contents of memory, registers and specified breakpoint 
addresses. Table 8-1 lists the paragraphs associated with each command for easier referencing. 


Table 8-1. Debug Commands 


Debug Command 


Paragraph Reference 


Activate Task 

8.3.4.1 

Assign Breakpoints 

8.3.3.1 

Assign Simulated Breakpoints 

8.3.6.1 

Delete and Proceed From Breakpoint 

8.3.3.3 

Deiete Breakpoints 

8.3.3.2 

Deiete Simulated Breakpoints 

8.3.6.2 

Execute and Hait Task 

8.3.4.5 

Find Byte 

8.3.5.1 

Find Word 

8.3.5.2 

Hait Task 

8.3.4.2 

initiate Debug Mode 

8.3.4.4 

List Breakpoints 

8.3.1. 1 

List Logicai Record 

8.3.1. 2 

List Memory 

8.3.1. 3 

List Simuiated Breakpoints 

8.3.6.3 

List System Memory 

8.3.1. 4 

Modify Absolute Disk 

8.3.2.1 

Modify Allocatabie Disk Unit 

8.3.2.2 

Modify internai Registers 

8.3.2.3 

Modify Memory 

8.3.2.4 

Modify Program image 

8.3.2.5 

Modify Reiative to Fiie 

8.3.2.6 

Modify System Memory 

8.3.2.7 

Modify Workspace Registers 

8.3.2.8 

Proceed from Breakpoint 

8.3.3.4 

Quit Debug Mode 

8.3.6.4 

Resume Simuiated Task 

8.3.6.5 

Resume Task 

8.3.4.3 

Show Absoiute Disk 

8.3.1. 5 

Show Aiiocatable Disk Unit 

8.3.1. 6 

Show Internal Registers 

8.3.1. 7 

Show Panel 

8.3.1. 8 

Show Program Image 

8.3.1. 9 

Show Relative to File 

8.3.1.10 

Show Value 

8.3.1.11 

Show Workspace Registers 

8.3.1.12 

Simulate Task 

8.3.6.6 
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8.3.1. 1 List Breakpoints — LB. The LB command is used for displaying the breakpoints for a 
specified task. If the breakpoints are to be displayed for a system task, the user must have a 
privileged user ID. 

Prompts: 

LIST BREAKPOINTS 

RUN ID: integer (*) 


Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

8.3.1 .2 List Logicai Record — LLR. The LLR command lists the contents of a record or records in 
a file. The contents of the record or records specified are listed in both hexadecimal and ASCII 
representation. The amount displayed per record is a maximum of decimai 512 (hexadecimal 200) 
or the logical record length of the file, whichever is less. 

Prompts: 

LIST LOGICAL RECORD 

PATHNAME 
STARTING RECORD 
NUMBER OF RECORDS 
LISTING ACCESS NAME 

Prompt Details: 

PATHNAME: 

The pathname that identifies the file In which the records to be listed reside. 
STARTING RECORD: 

A decimal or hexadecimal integer that Identifies the first record whose contents are to 
be listed. 

NUMBER OF RECORDS: 

A decimal or hexadecimal integer that identifies how many records are to be listed. A 
null response specifies that all records are to be listed. 

LISTING ACCESS NAME: 

The device name of a device or the pathname of a file to which the LLR command 
should write the contents of the record(s) specified. The default value is the terminal 
local file. 

8.3.1.3 List Memory — LM. The LM command is used to list the specified memory area of a 
task to a specified output device or file. If the task is not unconditionally suspended, it is tem- 
porarily suspended while the listing is being formatted. 


pathname® (*) 

Integer (0) 

[integer] 

[pathname®] 
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8 . 3 . 1 .4 Debugging a Program 


Prompts: 

LIST MEMORY 

RUN ID 
STARTING ADDRESS 
NUMBER OF BYTES 
LISTING ACCESS NAME 

Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

STARTING ADDRESS: 

The integer value which is the starting address of the memory area to be listed. 
NUMBER OF BYTES: 

The integer value which is the number of bytes of memory to be listed, beginning with 
the specified starting address. The default value is 16 bytes. 

LISTING ACCESS NAME: 

The device name or file name of the device or file where the memory list is to be output. 
The default value is the terminal local file. 


integer (*) 

full exp 
[full exp] 

[pathname®] 


8.3.1.4 List System Memory — LSM. The LSM command is used to list the memory occupied 
by the DNOS operating system. This command is similar to the List Memory (LM) command, 
except the user specifies an overlay name or ID instead of a run ID. 

The LSM command is intended for use only by someone very familiar with DNCS source code. 


Prompts: 


LIST SYSTEM MEMCRY 

CVERLAY NAME CR ID 
STARTING ADDRESS 
NUMBER CF BYTES 
LISTING ACCESS NAME 


{integer/alphanumeric} 

integer 

[integer] 

[pathname®] 


Prompt Details: 

CVERLAY NAME CR ID: 

The overlay name or integer value specified in the Install Cverlay (1C) command which is 
the ID of the overlay whose memory is to be listed. By executing the Map Program File 
(MPF) command on the kernel program file, (whose name is specified at system genera- 
tion, the user may inspect the acceptable overlay names and associated IDs. 

STARTING ADDRESS: 

The integer expression which is the starting address of the memory area to be listed. 
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NUMBER OF BYTES: 

The integer value which is the number of bytes of memory to be listed, beginning with 
the specified starting address. The initial value is >40 bytes. 

LISTING ACCESS NAME: 

The device name or file name where the memory list is to be output. The default value is 
the terminal local file. 

8.3.1.5 Show Absolute Disk — SAD. The SAD command is used to print the contents of a 
specified absolute address on a disk and may be executed only by privileged users. The contents 
of sixteen bytes are printed per line, with the address of the first byte printed as the first entry on 
the line. The contents of each pair of bytes are shown as four hexadecimal digits. At the right end 
of the line, the contents are printed as ASCII characters. The bytes that contain values that corres- 
pond to printable ASCII characters are translated and printed as ASCII characters; nonprinting 
ASCII characters are printed as periods. 

Prompts: 

SHCW ABSCLUTE DISK 


DISK UNIT 

devIcename® 


TRACK 

integer exp 


SECTCR 

integer exp 


FIRST WCRD 

integer exp 

(0) 

NUMBER CF WCRDS 

[Integer exp] 


CUTPUT ACCESS NAME 

[pathname®] 

n 

Prompt Details: 



DISK UNIT: 




The device name assigned to the disk during system generation. Normally, the 
characters DS01 are used for the system disk and DSxx for other disks on the system; 
where xx is a two digit decimal number less than or equal to ten (for example DS02). 

TRACK: 

The integer value that is the starting track address from which to begin printing the con- 
tents of the disk. 

SECTCR: 

The integer value that is the starting sector address, within the specified disk track, 
from which to begin printing the contents of the disk. 

FIRST WCRD: 

The integer value that is the word offset, within the specified disk sector, from which to 
begin printing the contents of the disk. 

NUMBER CF WCRDS: 

The integer value that is the number of words of the specified sector to print. The 
default value is the disk sector size. 
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OUTPUT ACCESS NAME: 

The device name or file name of a device or file where the contents of the specified 
absolute disk address is to be printed. The default value is the terminal local file. 

8.3. 1.6 Show Allocatable Disk Unit — SADU. The SADU command is used to output the con- 
tents of the specified allocatable disk units (ADUs) to the specified device. 

All disks on a DNOS system are addressed in ADUs, the basic addressable disk unit in a DNOS 
system. The maximum number of ADUs on a disk is 65,535. Therefore, if a disk contains more than 
65,535 sectors, multiple sectors are used as ADUs. 


Prompts: 


SHOW ALLOCATABLE DISK UNIT 

DISK UNIT: 
ADU NUMBER: 
SECTOR OFFSET: 
FIRST WORD: 
NUMBER OF WORDS: 
OUTPUT ACCESS NAME: 


devIcename® 
integer exp 
integer exp 
integer 
[integer exp] 
[pathname®] 


( 0 ) 

(*) 


Prompt Details: 


DISK UNIT: 

The device name assigned to the disk during system generation. Normally, the 
characters DS01 are used for the system disk and DSxx for other disks on the system, 
where xx is a two-digit decimal number greater than one (e.g., DS02). 


ADU NUMBER: 

The integer value that is the ADU with contents to be listed. 

SECTOR OFFSET: 

The integer value that is the sector of the ADU with contents to be listed. 

FIRST WORD: 

The integer value that is the word offset, within the specified sector, from which to 
begin listing the contents of the ADU. 

NUMBER OF WORDS: 

The integer value that is the number of words of the specified sector to list. The default 
value is the disk ADU size. 


OUTPUT ACCESS NAME: 

The device or file name where the contents of the specified ADU are to be listed. The 
default value is the terminal local file. 


8.3.1.7 Show Internal Registers — SIR. The SIR command is used to display the task state and 
the contents of the internal registers of a task: program counter (PC), workspace pointer (WP), 
workspace register (WR), status register (ST), memory, and breakpoints. The STATE field is the 
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State of the task before it was suspended to show the contents of the internal registers. The re- 
mainder of the display reflects the internal register values in effect after the task was suspended. 

The character string representation of the status register follows the hexadecimal value and may 
include the following characters: 

L = Logical greater than P 

A = Arithmetic greater than X 

E = Equal S 

C = Carry M 

O = Overflow 

If the internal registers are to be shown for a system task, the user must have a privileged user ID. 
Prompts: 

SHOW INTERNAL REGISTERS 

RUN ID: integer (*) 


= Parity 

= XOP in progress 
= Privileged mode 
= Map file 


Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

8.3.1.8 Show Panel — SP. The SP command is used to display the debug panel for a specified 
task. If the task is not unconditionally suspended, it will be temporarily suspended while the 
panel is being formatted and displayed. The displayed task state is the state of the task before it 
was suspended. The debug panel consists of the following: 

• Internal registers 

• Workspace registers 

• Breakpoints 

• Memory display 

• Task state 


The SP command also shows the character string representation of the status register. 

If the debug panel to be displayed is for a system task, the user must have a privileged user ID. 
Prompts: 

SHOW PANEL 

RUN ID: integer (*) 

MEMORY ADDRESS: [full exp] 
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Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

MEMORY ADDRESS: 

The integer value that is the starting memory address for the memory portion of the 
debug panel display. The default value is the current PC address. 

8.3.1.9 Show Program Image — SPI. The SPI command is used to display the disk-resident 
memory image of a module (defined as a task, procedure, segment, or overlay) for a specified 
program. 

Prompts: 


SHOW PROGRAM IMAGE 

PROGRAM FILE: filename® (*) 

OUTPUT ACCESS NAME: [pathname®] (*) 

MODULE TYPE: {T/P/O/S} (*) 

MODULE NAME OR ID: {alphanumeric/integer} (*) 

ADDRESS: integer (*) 

LENGTH: integer (040) 


Prompt Details: 

PROGRAM FILE: 

The file name of or the LUNO assigned to the program file on which the program (task, 
procedure, overlay, or segment) has been installed. If a LUNO is specified in response 
to this prompt, it must be assigned prior to the execution of the SPI command. If zero is 
specified, the .S$SHARED program file is assumed. 

OUTPUT ACCESS NAME: 

The device name or file name where the display of the memory image of the program is 
to be written. The default value is the terminal local file. 

MODULE TYPE: 

The type of program with a memory image to be displayed. The following characters are 
valid responses: 

T = Task 
P = Procedure 
O = Overlay 
S = Program Segment 

MODULE NAME OR ID: 

The characters or the associated ID that identifies the program on the specified pro- 
gram file. 

ADDRESS: 

The integer value that is the starting address of the memory image to be displayed. 
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LENGTH; 

The integer value that is the number of words of the memory image to be displayed. 

8.3.1.10 Show Relative to File — SRF. The SRF command is used to display any word or group 
of words within a file. It assumes that the user has knowledge of the file structure and allows the 
user to address any word within the file. 

Prompts: 

SHOW RELATIVE TO FILE 


PATHNAME: 

filename® 

(*) 

RECORD NUMBER: 

integer 

(*) 

FIRST WORD: 

integer 

(*) 

NUMBER OF WORDS: 

[Integer] 


OUTPUT ACCESS NAME: 

[pathname®] 

(*) 


Prompt Details: 

PATHNAME: 

The name of the file with a record to be displayed. 

RECORD NUMBER: 

The integer value that is the record number within the file to be displayed. 

FIRST WORD: 

The integer value that is the byte offset within the record to be displayed. 

NUMBER OF WORDS: 

The integer value that is the number of words of the record to display. The default is to 
display the whole record. 

OUTPUT ACCESS NAME: 

The pathname of a device or file where the results of the SRF command are to be listed. 
The default is the terminal local file. 

8.3.1.11 Show Value — SV. The SV command is used to display the value of a specified expres- 
sion. The hexadecimal, decimal, and ASCII representations of the value are given. 

Prompts: 

SHOW VALUE 

EXPRESSION: full exp 


Prompt Details: 

EXPRESSION: 

The integer and/or character(s) expression with a value to be displayed. If a task is being 
debugged and is a controlled task, the expression may be symbolic. 
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8.3.1.12 Show Workspace Registers — SWR. The SWR command is used to display the current 
workspace of a task. If the task is not unconditionally suspended, it is temporarily suspended 
while the workspace is displayed. 

If the terminal requesting the command is a VDT, the SWR command functions the same as the 
Show Panel (SP) command. If the workspace to be displayed is for a system task, the user must 
have a privileged user ID. 

Prompts: 

SHOW WORKSPACE REGISTERS 

RUN ID: Integer (*) 

Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 


8.3.2 Data Modification Commands 

These commands are used to place specified data on a disk or change data at an absolute word 
address. Modification of specified ADUs, internal registers, memory image, or programs may be 
accomplished using these debugging commands. 

8.3.2.1 Modify Absolute Disk — MAD. The MAD command is used to place specified data on a 
disk at a specified absolute track, sector, and word address and may only be executed by privi- 
leged users. Data is entered in groups of word values to be placed on disk. Word values must be 
separated from each other with a comma and loaded on disk in successive addresses. The 
verification parameter allows the user to enter a string of words to be compared to the data at the 
specified address. If there is not a correspondence between the string of words and the data at 
the specified address, the modification does not take place. 


NOTE 

Since the MAD command has the capability to write anything, 
anywhere on the disk, and can therefore destroy the DNOS system 
image, the verify option should always be used. 


Prompts: 


MODIFY ABSOLUTE DISK 

DISK UNIT 
OUTPUT ACCESS NAME 
TRACK 
SECTOR 
FIRST WORD 
VERIFICATION DATA 
DATA 


devicename® 
[pathname®] 
integer exp 
integer exp 
integer exp 
[integer(s)] 
integer(s) 


(*) 
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Prompt Details: 

DISK UNIT: 

The device name of the disk device assigned during system generation. Normaily, the 
characters DS01 are used for the system disk and DSOx for other disks on the system, 
where x is a digit greater than one. 

OUTPUT ACCESS NAME: 

The device or file name where the contents of the specified absolute disk address are to 
be printed. The defauit vaiue is the terminai iocal fiie. 

TRACK: 

The integer vaiue which is the starting track address from which to begin the disk 
modification. 


SECTOR: 

The integer vaiue which is the starting sector address, within the specified disk track, 
from which to begin the disk modification. 

FIRST WORD: 

The integer vaiue which is the starting word address, within the specified disk sector, 
from which to begin the disk modification. 

VERiFICATION DATA: 

If specified, the integer vaiue contained in the specified starting address, if more than 
one integer is specified, they must be separated by commas; it is assumed these vaiues 
are contained in successive words, beginning with the specified first word. 

DATA: 

The integer vaiue to repiace the existing vaiue contained in the specified first word. If 
more than one value is specified, they must be separated by commas; it is assumed 
these values are to replace the existing values contained in successive words, begin- 
ning with the first word. 

8.3.2.2 Modify Allocatable Disk Unit — MADU. The MADU command is used to modify a 
specified allocatable disk unit (ADU). If verification data does not match the data already on the 
disk, modification will not be performed. 

All disks on a DNOS system are addressed in ADUs. The maximum number of ADUs on a disk is 
65,535. Therefore, if a disk contains more than 65,535 sectors, multiple sectors are used as ADUs. 
ADUs are the basic addressable disk unit in a DNOS system. 


Prompts: 


MODIFY ALLOCATABLE DISK UNIT 

DISK UNIT: 
OUTPUT ACCESS NAME: 

ADU NUMBER: 
SECTOR OFFSET: 
FIRST WORD: 
VERIFICATION DATA: 

DATA: 


devicename® 

[pathname®] (*) 

integer exp 

integer exp 

integer exp 

[integer exp list] 

integer exp list 
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Prompt Details: 

DISK UNIT: 

The device name of the disk assigned during system generation. Normally, the 
characters DS01 are used for the system disk and DSOx for other disks on the system, 
where x is a digit greater than one. 

OUTPUT ACCESS NAME: 

The device or file name where the results of the ADU modification are to be listed. The 
default value is the terminal local file. 

ADU NUMBER: 

The integer value which is the ADU with contents to be modified. 

SECTOR OFFSET: 

The integer value which is the sector of the ADU with contents to be modified. 

FIRST WORD: 

The integer value which is the starting word offset, within the specified sector, where 
modifications of the ADU are to begin. 

VERIFICATION DATA: 

If specified, the integer value contained in the specified first word address. If more than 
one integer is specified, they must be separated by commas; it is assumed these values 
are contained in successive words, beginning with the specified first word. 

DATA: 

The integer value to replace the existing value contained in the specified first word. If 
more than one value is specified, they must be separated by commas; it is assumed 
these values are to replace the existing values contained in successive words, begin- 
ning with the first word. 

8.3.2.3 Modify internal Registers — MIR. The MIR command is used to modify the internal 
registers of a task: program counter (PC), workspace pointer (WP), and status register (ST). If the 
task being debugged is not a privileged task, then only bits 0 through 6 of the status register can 
be modified with this command. If the task is not unconditionally suspended, it is temporarily 
suspended while the command is interacting with the register modification. 

As in the Modify Memory (MM) command, the MIR command is interactive; the RETURN key may 
be pressed after the register and its contents have been displayed and/or modified to cause the 
next register and its contents to be displayed. Also, by pressing the Command (CMD) key, SCI is 
returned to command mode. 

If the internal registers to be modified are for a system task, the user must have a privileged user 
ID. 

Prompts: 

MCDIFY INTERNAL REGISTERS 

RUN ID: integer (*) 
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Prompt Details: 

RUN ID; 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command, 

8.3.2.4 Modify Memory — MM. The MM command is used to modify the memory image of a 
task, starting at the address specified. If the task is not unconditionally suspended, it is tem- 
porarily suspended while the command is interacting. Swapping does not affect the modification 
process. Consecutive memory addresses, and their values, may be displayed and/or modified by 
pressing the RETURN key. Pressing the Command (CMD) key will return SCI to command mode. 

Prompts: 

MODIFY MEMORY 

RUN ID: integer (*) 

ADDRESS: full exp 

Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

ADDRESS: 

The integer value of the first memory address to be modified. 

8.3.2.5 Modify Program Image — MPl. The MPI command is used to modify a program (defined 
to be a task, procedure, or overlay) in a specified program file. 

Prompts: 

MODIFY PROGRAM IMAGE 


PROGRAM FILE 

filename® 

n 

OUTPUT ACCESS NAME 

[pathname®] 

n 

MODULE TYPE 

{T/P/O/S} 

n 

MODULE NAME OR ID 

{alphanumeric/integer} 

n 

ADDRESS 

integer 

n 

VERIFICATION DATA 

[integer(s)] 


DATA 

integer(s) 


CHECKSUM 

[integer(s)] 


RELOCATION OF DATA? 

[YES/NO...YES/NO] 



Prompt Details: 

PROGRAM FILE: 

The file name of or the LUNO assigned to the program file on which the program (task, 
procedure, segment, or overlay) to be modified has been installed. If a LUNO is 
specified in response to this prompt, it must be assigned prior to the execution of the 
MPI command. If zero is specified, the .S$SHARED program file is assumed. 
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OUTPUT ACCESS NAME: 

The device name or file name where the results of the memory image modification of 
the program are to be written. If a null response is specified, the terminal local file is 
used. 

MODULE TYPE: 

The type of program with a memory image to be modified. The following characters are 
valid responses: 

T = Task 
P = Procedure 
O = Overlay 
S = Program Segment 

MODULE NAME OR ID: 

The character(s) or the associated ID which identifies the program on the specified pro- 
gram file. 

ADDRESS: 

The integer value which is the starting address of the memory image to be modified. 
VERIFICATION DATA: 

If specified, the integer value contained in the specified starting address. If more than 
one integer is specified, they must be separated by commas; it is assumed these values 
are contained in consecutive memory addresses, beginning with the specified starting 
address. 

DATA: 

The integer value to replace the existing value contained in the specified starting 
address. If more than one value is specified, they must be separated by commas; It is 
assumed these values are to replace the existing values contained in consecutive 
memory addresses, beginning with the specified starting address. 

CHECKSUM: 

The checksum is an exclusive OR of each word of new data. If the checksum is not 
known and a null response is entered, the checksum will be printed to the device or file 
specified in response to the OUTPUT ACCESS NAME: prompts. 

RELOCATION OF DATA?: 

If YES is specified, the data value will be relocated when the task is loaded into memory 
for execution. NO specifies that the data value will not be relocated. If a list of data 
values are specified in response to the DATA prompt and relocation is desired, the user 
must specify which values are to be relocated. That is, a YES or NO response must be 
entered for each corresponding data value. If there is a list of YES or NO responses, 
they must be separated by commas. 

8.3.2.6 Modify Relative to File — MRF. The MRF command changes data at an absolute word 
address within a file. It is assumed that the user has knowledge of the file and disk structure. 
Addresses above 64K (65,536) bytes must have a record number and sector offset supplied by the 
user. Words below 64K bytes can be addressed directly and the sector is located by the program. 
Verification should be used, when possible. 
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Prompts: 


MODIFY RELATIVE TO FILE 

PATHNAME 
OUTPUT ACCESS NAME 
RECORD NUMBER 
FIRST WORD 
VERIFICATION DATA 
DATA 
CHECKSUM 


filename® 

[pathname®] 

integer 

integer 

[integer... integer] 
integer.. .integer 
[integer] 


Prompt Details: 

PATHNAME; 

The file name with contents to be modified. 


OUTPUT ACCESS NAME: 

The device name or file name where the results of the MRF command will be listed. If a 
null response is specified, the terminal local file is used. 

RECORD NUMBER: 

The integer value which is the physical record number within the file to be modified. If 
the specified word address Is over 64K bytes, the user must supply the sector offset as 
the response to this prompt. 

FIRST WORD: 

The integer value which is the starting byte offset where the modification of the record 
is to begin. The byte offset must be on an even boundary. 

VERIFICATION DATA: 

If specified, the integer value contained in the specified first word address. If more than 
one integer is specified, they must be separated by commas; it is assumed these values 
are contained in successive word addresses, beginning with the specified first word 
address. 


DATA: 

The integer value to replace the existing value contained in the specified first word 
address. If more than one value is specified, they must be separated by commas; it is 
assumed these values are to replace the existing values contained in successive word 
addresses, beginning with the specified first word address. 

CHECKSUM: 

The checksum is an exclusive OR of each word of new data. If the checksum is not 
known and a null response is entered, the checksum will be printed to the device or file 
specified in response to the OUTPUT ACCESS NAME: prompt. 
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8.3.2.7 Modify System Memory — MSM. 


CAUTION 

This command is available for use only by Ti representatives. 


The MSM command is used to modify the memory occupied by the DNOS operating system, it is 
simiiar to the Modify Memory (MM) command, except that an overiay name or iD is specified 
instead of a task run iD. Consecutive memory addresses may be dispiayed and/or modified by 
pressing the RETURN key. Pressing the Command (CMD) key returns SCi to command mode. 

Prompts: 

MODIFY SYSTEM MEMORY 

OVERLAY NAME OR ID: {integer/alphanumeric} 

ADDRESS: integer 


Prompt Details: 

OVERLAY NAME OR ID: 

The overlay name or integer value which is the ID of the overlay installed on the kernel 
program file with a memory to be modified. By executing the Map Program File (MPF) 
command on the kernel program file (whose name is specified at system generation), 
the user may inspect the acceptable overlay names and associated IDs. 

ADDRESS: 

The integer value of the memory address at which to begin modifying memory. 

8.3.2.8 Modify Workspace Registers — MWR. The MWR command is used to modify specific 
workspace registers of a task. If the task is not unconditionally suspended, it is temporarily 
suspended while the command is modifying the registers. 

As in the Modify Memory (MM) command, the MWR command is interactive; the RETURN key 
must be pressed to enter a new value for a workspace register. Also, pressing the command 
(CMD) key will terminate the MWR command and place SCI in command mode. 

If the workspace registers to be modified are for a system task, the user must have a privileged 
user ID. 


8.3.3 Breakpoint Commands 

The purpose of setting breakpoints is to suspend the task at critical points in its execution in 
order to examine the memory contents of specified address(es). 

8.3.3.1 Assign Breakpoints — AB. The AB command is used to replace the specified contents 
of the address(es) of a task with a breakpoint (an XOP 15,15 instruction >2FCF), which stops 
execution of the task at that location. Thus, a task may be suspended at any location in its 
execution. 
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The task is temporarily suspended, while the breakpoints are inserted, then restored to its original 
state. Unless the task is being simulated, the user must monitor the task with the Show Internal 
Registers (SIR) or Show Panel (SP) command to determine when it reaches a breakpoint. When the 
breakpoint occurs, the task is placed in task state 6 (unconditional suspend). To proceed, the Pro- 
ceed from Breakpoint (PB), Delete and Proceed from Breakpoint (DPB), or the Delete Breakpoint 
(DB) and Resume Task (RT) commands must be executed. 

The contents of the address(es) are saved and can be restored by the Delete Breakpoints (DB) 
command. A maximum number of breakpoints can be in effect within a job at any one time; an 
attempt to use more than this number of breakpoints generates an error message. If the run-time 
ID specifies a system task, the user must be a privileged user or the command is aborted. Break- 
points may not be assigned when working in the DNOS system area. 

The DB, DPB, RT, PB, and ST commands are discussed later in this section. 

Prompts: 

ASSIGN BREAKPOINT 

RUN ID: integer (*) 

ADDRESS(ES): full exp list 


Prompt Details: 

RUN ID: 

A valid run ID in the user’s current job. Current run IDs may be obtained by executing the 
Show Task Status (STS) command. 

ADDRESS(ES): 

The integer value(s) of the address(es) within the task where the breakpoint(s) are to 
occur. Addresses must be separated by a comma. 

8.3.3.2 Delete Breakpoints — DB. The DB command is used to delete a breakpoint(s) from a 
specified address(es) in a task and restore the original value at the address(es) that was replaced 
with an XOP 15,15 Instruction by the AB command. The task is temporarily suspended while the 
breakpoint(s) is deleted; then the original task state is restored. Deleting a breakpoint at which a 
task is stopped does not cause the task to resume execution; the Resume Task (RT) command 
must be used to cause the task to resume execution. 

The parameters of the DB command are interpreted by the DB processor as in the AB command, 
with the following exceptions: 

• If no address is specified in response to the ADDRESS(ES): prompt, the breakpoint at 
which the task is currently stopped is deleted. 

• If ALL is specified in response to the ADDRESS(ES): prompt, all breakpoints for that 
task are deleted. 

• If the breakpoint does not exist at the specified address, or a breakpoint within a list of 
breakpoints does not exist, the user is warned with an error message followed by a 
display of the debug panel to show the breakpoint status. 
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8.3.3.3 Delete and Proceed from Breakpoint — DPB. The DPB is used to proceed from a break- 
point at which a task is currently stopped and to delete that breakpoint. If the breakpoint has 
already been deleted, the command functions as if it were a Proceed from Breakpoint (PB) 
command. 

Prompts: 

DELETE AND PROCEED FROM BREAKPOINT 

RUN ID: integer (*) 

DESTINATION ADDRESS(ES); [full exp list] 

Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

DESTINATION ADDRESS(ES): 

The integer value(s) of the address(es) within the task which are additional breakpoints 
to be set. A null response specifies that no new breakpoints are to be set. 

8.3.3.4 Proceed from Breakpoint — PB. The PB command is used to resume execution of a 
task that is stopped at a breakpoint without deleting the breakpoint. The task is resumed, 
executing the instruction at the breakpoint at which it is currently stopped; however, the break- 
point remains active. If the task is not currently at a breakpoint, the user is notified by a warning 
message that the task is not at a breakpoint, and the task remains in whatever state it was in 
before the PB command. 

The PB command may also be used to assign new breakpoints in the specified task by responding 
to the DESTINATION ADDRESS(ES) prompt. Breakpoints are set, if possible, at all the specified 
destination addresses. If no destination address(es) is specified, the task resumes execution but 
no breakpoints are set. 

Prompts: 

PROCEED FROM BREAKPOINT 

RUN ID: integer (*) 

DESTINATION ADDRESS(ES): [full exp list] 

Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

DESTINATION ADDRESS(ES): 

The integer value(s) of the address(es) within the task where the new breakpoints are to 
occur. Addresses must be separated by a comma. The default value is no new 
breakpoints. 
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8.3.4 Task Control Commands 

The control commands are used to unconditionally suspend and activate the task during the 
debugging process. 

8.3.4.1 Activate Task — AT. The AT command is used to activate an unconditionally sus- 
pended task. 

Prompts: 

ACTIVATE TASK 

RUN ID: integer (*) 


Prompt Details: 

RUN ID: 

A valid task run ID in the user’s job. Current run IDs may be obtained by executing the 
Show Task Status (STS) command. 

8.3.4.2 Halt Task — HT. The HT command is used to unconditionally suspend a task at the end 
of the current time slice. If the task is already unconditionally suspended, it has no effect on the 
task. If the task is not in the active state, the HT command waits five seconds for the task to reach 
unconditional suspend, then gives the user the option of aborting or continuing to wait. This 
option occurs every five seconds if the task is not active and the HT command is executed. 

If the task cannot be suspended, the following message is displayed: 

UNABLE TO SUSPEND TASK. CURRENT STATE®XX. CONTINUE COMMAND? 

If a YES response is entered, another attempt is made to suspend the task. If unsuccessful, the 
message is dispiayed again. A NO response to the preceding message causes the foilowing 
message to be displayed: 

DO YOU WISH TO LEAVE SUSPENSION PENDING? 

A YES response leaves the suspension pending, while a NO response terminates the suspension 
attempt. 

if the specified task is a system task, the user must have a privileged user ID. 

Prompts: 

HALT TASK 

RUN ID: integer (*) 


Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 
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8.3.4.3 Resume Task — RT. The RT command is used to activate a task at the point at which it 
was suspended. The specified task must be unconditionally suspended when this command is 
executed or an error is indicated. The Delete Breakpoint (DB) and the RT command, Delete and 
Proceed from Breakpoint (DPB) or Proceed from Breakpoint (PB) commands must be used to 
restart a task halted at a breakpoint. The RT command should be used instead of the Activate 
Task (AT) command, to reactivate a task halted by the Halt Task (HT) command. 

Prompts: 

RESUME TASK 

RUN ID; integer (*) 


Prompt Details: 

RUN iD: 

The response to this prompt must be a valid run ID in the user’s job. Current run IDs may 
be obtained by executing the Show Task Status (STS) command. 

8.3.4.4 Execute in Debug Mode — XD. The XD command is used to place a specified task into 
controlled mode. The run-time ID is optional but cannot be the ID of a system task. If no run-time 
ID is specified, an automatic call is made to the Execute and Halt Task (XHT) command to place 
the task into execution. 

The symbol table object file is optional and its presence determines whether symbolic expres- 
sions are allowed on any of the subsequent debug commands. If a symbol table was specified to 
the Link Editor (SYMT option was selected) and if the controlled task symbol table object file is 
specified, then symbolic expressions involving symbols in the object code symbol table may be 
used in commands that call for string parameters. 

The debugger may be used to simulate 990 computer object code. The command defaults to the 
object code of the host computer. 

Only one task for each station may be in debug mode at a given time. 

Prompts: 

EXECUTE IN DEBUG MODE 

RUN ID; [integer] (*) 

SYMBOL TABLE OBJECT FILE: [filename®] (*) 

990/12 OBJECT CODE?; YES/NO (YES) 


Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

If a null response is specified, the prompts for the Execute and Halt Task (XHT) 
command are displayed. Refer to the XHT command for information concerning 
responses to these prompts. 
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SYMBOL TABLE OBJECT FILE: 

The file name specified to the Link Editor if the SYMT option has been seiected. By 
specifying this fiie name in response to the prompt, the user is ailowed to use symboiic 
expressions which invoive symbols in the object code symbol table on any debug 
command prompt which calis for a character(s) response. If a null response is entered, 
no symbol table file is used and symbolic expressions are not ailowed. 

990/12 OBJECT CODE?: 

If YES is entered in response to this prompt, the debugger will simulate 990/12 object 
code if executing on a 990/12 computer. If NO is entered, the debugger will simulate 
990/10 object code whether executing on a 990/10 or 990/12 computer. 

8.3.4.5 Execute and Halt Task — XHT. The XHT command is used to piace a task in memory in 
a suspended state so that it can be debugged. Typicaiiy, the user places the task to be debugged 
in memory using XHT, establishes the debug environment (including breakpoints), and then 
activates the task using the Resume Task (RT) command. 

Prompts: 

EXECUTE AND HALT TASK 


PROGRAM FILE OR LUNO: 

{filename@/integer} 

(*) 

TASK NAME OR ID: 

{alphanumeric/integer} 

(*) 

PARM1: 

integer 

(0) 

PARM2: 

integer 

(0) 

STATION ID: 

{integer/ME} 

{*) 


Prompt Details: 

PROGRAM FILE OR LUNO: 

The file name of or the LUNO assigned to the program fiie on which the task has been 
installed. If a LUNO is specified in response to this prompt, it must be assigned prior to 
the execution of the XHT command. If zero Is specified, the .S$SHARED program file is 
used. 

TASK NAME OR ID: 

The name or the associated installed ID of the task whose execution is to be halted. 
PARM1: 

An integer value to be passed to the task being halted, determined by the programmer 
who wrote the task. 

PARM2: 

A second integer value to be passed to the task being halted, determined by the pro- 
grammer who wrote the task. 

STATION ID: 

The station ID (e.g., 1, 2) with which the task is to be associated or the two-character 
pseudo device name of ME. If >FF is entered, the task is not associated with any 
station. 
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8.3.5 Search Commands 

The search commands are used to search for the specified value(s) in a memory area of a task. 

8.3.5.1 Find Byte — FB. The FB command is used to search for the specified value(s) in a 
memory area of a task; with the search beginning on a byte boundary. If the specified vaiue is 
found, the corresponding memory address is displayed. If the task is not unconditionally 
suspended, it is temporarily suspended while the search is performed. 

Prompts: 

FIND BYTE 

RUN ID 
VALUE(S) 

STARTING ADDRESS 
ENDING ADDRESS 


integer (*) 

full exp list 
[full exp] 

[full exp] 


Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 

VALUE(S): 

The integer value(s) to find in the memory area of the task. 

STARTING ADDRESS; 

The integer value which is the starting address of the memory area to be searched. The 
default is zero. 

ENDING ADDRESS: 

The integer value which is the ending address of the memory area to be searched. The 
default is end of task. 


8.3.5.2 Find Word — FW. The FW command is used to search for the specified value(s) in a 
memory area of a task; with the search beginning on a word boundary. If the specified value is 
found, the corresponding memory address is displayed. If the task is not unconditionally 
suspended, it is temporally suspended while the search is performed. 


Prompts: 


FIND WORD 

RUN ID 
VALUE(S) 
STARTING ADDRESS 
ENDING ADDRESS 


integer 
full exp list 
[full exp] 
[full exp] 


n 


Prompt Details: 

RUN ID: 

A valid run ID in the user’s job. Current run IDs may be obtained by executing the Show 
Task Status (STS) command. 
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VALUE(S): 

The integer value(s) to find in the memory area of the task. 

STARTiNG ADDRESS: 

The integer value which is the starting address of the memory area to be searched. If an 
odd address is specified, the address is rounded up to the nearest even value. The 
default is zero. 

ENDING ADDRESS: 

The integer value which is the ending address of the memory area to be searched. The 
default address is the end of task. 


8.3.6 Controlled Task Commands 

The control commands allow control and trace execution of instructions in a task until: 

• The execution of a specified number of instructions has been simulated. 

• A specified address is placed in the PC. 

• A breakpoint or simulated breakpoint occurs. 

8.3.6.1 Assign Simulated Breakpoint — ASB. The ASB command is used to set up a breakpoint 
on a range of values for memory as follows: 

• Memory alteration (A) 

• CRU access (C) 

• Program Counter value (P) 

• Memory references (R) 

• Status register value (S) 

A memory write operation, which does not change the value in memory, is not a memory altera- 
tion. The breakpoints set with this command are only valid during a Simulate command. Break- 
points, in this case, are conditions which stop execution but allow execution to be resumed by an 
operator command, either by using the Resume Simulated Task (RST) command or by pressing 
the F3 function key. Each simulated breakpoint is assigned a number which is displayed at the 
completion of the ASB command. When a breakpoint occurs during simulation, a panel and the 
breakpoint number are displayed along with the display string. 

Prompts: 

ASSIGN SIMULATED BREAKPOINT 


ON (A,C,P,R,S): 

{A/C/P/R/S} 

(PC) 

FROM: 

full exp 


THRU: 

[full exp] 


COUNT: 

full exp 

(1) 

DISPLAY: 

[full exp] 
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Prompt Details: 

ON (A,C,P,R,S): 

The characters A, C, P, R, S are valid responses to this prompt and have the following 
meanings: 

A = Memory alteration 
C = CRU access 
P = Program Counter value 
R = Reference (memory) 

S = Status Register value 


FROM: 

The integer expression that specifies the lower address limit for breakpointing. 

THRU: 

The integer expression that specifies the upper address limit for breakpointing. The 
default value is the value specified for the FROM: prompt. 

COUNT: 

The integer expression that specifies the number of times this breakpoint is to be 
encountered before execution is halted. The default value is one. 

DISPLAY: 

The integer expression that specifies the memory address to be displayed when this 
breakpoint is reached. The default value is the PC value at the time the breakpoint is 
reached. 

8.3.6.2 Delete Simulated Breakpoints — DSB. The DSB command is used to allow the user to 
delete a list of simulated breakpoints assigned with the Assign Simulated Breakpoint (ASB) 
command. 

Prompts: 

DELETE SIMULATED BREAKPOINTS 

BREAKPOINT NUMBERS: [full exp list/ALL] 

Prompt Details: 

BREAKPOINT NUMBERS: 

The integer value that specifies the number of the breakpoint to delete, which was the 
breakpoint number returned by the ASB command. If the characters ALL are entered, all 
the simulated breakpoints are deleted. The default is the breakpoint at which the task is 
stopped. Current simulated breakpoints may be obtained by executing the List 
Simulated Breakpoints (LSB) command. 

8.3.6.3 List Simulated Breakpoints ~ LSB. The LSB command is used to display all current 
simulated breakpoints. When the breakpoints are listed, the first column of the display lists the 
numbers assigned when the breakpoints were set; the numbers start at one and are consecutive. 
The TYPE column lists letters for the ON prompt of an Assign Simulated Breakpoint command to 
identify the value on which the breakpoint was set, and the FROM and THRU columns list the 
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corresponding operand addresses. The COUNT column lists the count operand entered when the 
breakpoints were set, and the REMAINING column lists the number of times the program has yet 
to go through the breakpoint. The DISPLAY column lists the display operand. 

When the operands represent CRU addresses or ST register values, the operands are listed as 
hexadecimal numbers. 

Prompts: 

None 

8.3.6.4 Quit Debug Mode — QD. The QD command is used to take a controlled task out of 
debug mode. The user has the option of killing the task at this point. If the user chooses not to kill 
the task, it will be left unconditionally suspended; but the user may still issue any of the general 
SCI commands. The Resume Task (RT) or Proceed from Breakpoint (PB) commands (depending on 
whether the task is at a breakpoint) may be used to activate the task. 

The RT command is discussed in the task control commands paragraphs. 

Prompts: 

QUIT DEBUG MODE 

KILL TASK?: YES/NO (YES) 


Prompt Details: 

KILL TASK?: 

If YES is entered, the current executing task will be killed. The task then executes its 
end-action routine. If NO is entered, the current executing task will be unconditionally 
suspended. 

8.3.6.5 Resume Simulated Task — RST. The RST command is used to allow the user to resume 
simulation following a breakpoint, a simulated breakpoint, or simulation of a specified number of 
instructions. The last entered values for the FOR: and TO: prompts of the Simulate Task (ST) com- 
mand are used as the RST limits. Upon reaching a terminating condition (breakpoint, simulated 
breakpoint, time-out or the value specified for the TO: prompt), a panel and termination reason are 
displayed. Simulation may be continued by pressing the F3 function key or terminated by press- 
ing the Command (CMD) key, which returns SCI to the command mode. 

8.3.6.6 Simulate Task — ST. The ST command is used to provide controlled and traced execu- 
tion of the instructions in a task. Controlled execution continues until the execution of a specified 
number of instructions has been simulated or until a specified address is placed in the PC or until 
a breakpoint or simulated breakpoint occurs. Simulation may be continued by pressing the F3 
function key. 

Simulated execution continues without operator Intervention and locks out further SCI com- 
mands. Following simulation of the instruction whose address is specified by the response to the 
TO: prompt, SCI displays the panel and halts simulation. The user can regain SCI capabilities by 
pressing the Command (CMD) key to return to command mode. 
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When the number of specified simuiations has been performed, SCi displays the following 
message and halts simulation: 

TIME OUT 

Prompts: 

SIMULATE TASK 

FOR: [full exp] (*) 

FROM: [full exp] 

TO: [full exp] 


Prompt Details: 

FOR: 

The integer expression that specifies the number of instruction simulations to be per- 
formed and must be less than or equal to 32,767. When the specified number of simula- 
tions has been performed, SCI displays the following message and halts simulation: 

TIMEOUT 

If a null response is entered for this prompt, the value specified in a previous ST com- 
mand is used; if no previous ST commands were executed, a one is used. 

FROM: 

The integer expression that specifies the address of the first instruction to be 
simulated. If a null response is entered in response to this prompt, simulation begins at 
the instruction with an address in the PC. 


TO: 

The integer expression that specifies the address of the last instruction to be 
simulated. The integer expression entered may be less than that entered for the FROM 
command. If a null response is entered in response to this prompt, simulation con- 
tinues until a breakpoint or simulated breakpoint is encountered or until the user 
presses the CMD key, returning SCI to command mode. 

Messages: 

STOP AT TRAP NO. X 

where X is the number of the simulated breakpoint set through the Assign Simulated Break- 
point (ASB) command. 
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8.4 STATION DEPENDENT DISPLAYS 

As mentioned previously, the displays generated by debugging SCI commands vary in format and 
content depending on the display device. High-speed display terminals (such as Video Display 
Terminals) display more information than slower, hard copy terminals. Table 8-2 lists the display 
generated by several of the debug commands in varying environments. 


Table 8-2. Command Displays 


Command 

Hard Copy 
Regular 

Hard Copy 

Debug 

VDT 

Regular 

VDT 

Debug 

AB 

— 

— 

— 

PANEL 

DB 

— 

— 

— 

PANEL 

PB 

— 

— 

— 

PANEL 

DBP 

— 

— 

— 

PANEL 

LB 

BRKPTS 

BRKPTS 

BRKPTS 

BRKPTS 

HT 

— 

— 

— 

PANEL 

RT 

— 

— 

— 

PANEL 

MM 

INTERACT 

INTERACT 

INTERACT 

INTERACT PANEL 

LM 

TLF 

TLF 

LF 

TLF 

FW 

MSG OR TLF 

MSG OR TLF 

MSG OR TLF 

MSG -I- PANEL OR TLF 

FB 

MSG OR TLF 

MSG OR TLF 

MSG OR TLF 

MSG PANEL OR TLF 

SIR 

INT REG 

INT REG 

PANEL 

PANEL 

MWR 

INTERACT 

INTERACT 

INTERACT 

INTERACT PANEL 

SWR 

WKSPC 

WKSPC 

PANEL 

PANEL 

SP 

PANEL 

PANEL 

PANEL 

PANEL 

SV 

VALUES 

VALUES 

VALUES 

VALUES 

XD 

— 


— 

PANEL 

ASB 

— 

— 

— 

BRKPT NO. PANEL 

DSB 

— 

— 

— 

PANEL 

LSB 

— 

SIMULATED BRKPTS 

— 

SIMULATED BRKPTS 

ST 

— 

TRAP#ORTIMEOUT’ 

— 

TRAP#ORTIMEOUT’ 

-f PANEL 

RST 

— 

TRAP#OR’TIMEOUT’ 

— 

TRAP#OR’TIMEOUT’ 

-I- PANEL 

QD 

— 

— 

— 

— 


BRKPTS = Breakpoints 

TIMEOUT = Time-out 

INTERACT = Interactive 

TLF = Terminal local file 

INT REG = Internal registers 

TRAP#OR = Trap number 

MSG = Message 

WKSPC = Workspace 

PANEL = Debug panel 
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9.1 EXAMPLE PROGRAMMING 

This paragraph describes a simple procedure for creating and executing an assembly language 
program using DNOS. This brief program is assembled with the SYMT command entered in the 
OPTIONS?: prompt of the Execute Macro Assembler (XMA) command. 

This program may be assembler without the Symbol Table by omitting the SYMT OPTION in the 
XMA command; however, symbolic debugging cannot be performed without the Symbol Table. 

The program is debugged in three different ways: 

• Symbolic Debugging — The Symbol Table is supplied to the linked object making the 
addresses of the labels in the program recognizable to the debugger. 

• Breakpoint Debugging — Breakpoints are assigned to addresses in the executed pro- 
gram. When a breakpoint is reached, execution halts, and the panel is displayed, show- 
ing the address values of the breakpoint. 

• Simulated Debugging — Used In the same example as the symbolic debugging. The 
address values are displayed for the address range specified during the Assign 
Simulated Breakpoints (ASB) command until a breakpoint or end of execution is 
reached. 

The examples also explain how to write messages to the terminal, or to an assigned file by assign- 
ing a Logical Unit Number (LUNO) to the terminal or file. 

An example is supplied, near the end of the section, describing the execution of a previously 
debugged program. 

For more detailed information on how to code a program, consult the Assembly Language 
Reference Manual. 

The brief assembly language example given In this section displays a message and requests the 
input of three numbers. The program, for this example, was used as the Text Editor Example 
(Figure 4-1) and entered in file .USER.SOURCE. 

The procedures given in this section are for use on a 911 VDT. 
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9.2 Assembly Language Program Example 


The directory .USER, previously created in the section on building a program, is used to simplify 
file references during assembly and execution. A suggested syntax is as follows: 


Source file: 

Object file: 

Listing file: 

Link edit listing file: 
Linked output file: 
Error file: 

Message file: 

Link edit control file: 


.USER.SOURCE 

.USER.OBJECT 

.USER.LISTING 

.USER.LNKLIST 

.USER.LNKOUT 

.USER.ERROR 

.USER.MESSAGE 

.USER.CNTRLINK 


The volume name is optional if the system disk (DS01) is used, and it may be omitted. 


The .USER.SOURCE file is already created. The remaining files, except .USER.MESSAGE are 
created automatically by the following procedures. It is necessary to create the file 
.USER.MESSAGE, using the Create File Sequential (CFSEQ) command, as shown below: 

[] CFSEQ 


CREATE SEQUENTIAL FILE 

PATHNAME 
LOGICAL RECORD LENGTH 
PHYSICAL RECORD LENGTH 
INITIAL ALLOCATION 
SECONDARY ALLOCATION 
EXPANDABLE? 
BLANK SUPPRESS? 
FORCED WRITE? 


.USER.MESSAGE 
<Press RETURN> 
<Press RETURN> 
<Press RETURN> 
<Press RETURN> 
YES 
NO 
NO 


The messages produced by the program are written to this file instead of the terminal, since SCI 
has command of the terminal. 


9.2 REVIEW OF TEXT EDITING 

A quick review on entering the program into the computer is discussed in this paragraph. 

1. Power up the computer and terminal and log-on using the procedures given in Section 2. 

2. Invoke the Text Editor by entering the Execute Editor (XE) command. The following 
parameter appears: 

[]XE 

EXECUTE TEXT EDITOR 

FILE ACCESS NAME: <Press TAB key> 

3. Press the unlabeled gray key or the RETURN key to create the first blank line above the 
’‘EOF record. 
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4. Type in the program source code. 

5. Press CMD, after entering the source code, to leave the compose mode. 

6. Enter the Quit Editor (QE) command to quit the Text Editor. Select the following 
parameters: 

IIQE 
QUIT EDIT 

ABORT?: NO 

QUIT EDIT 

OUTPUT FILE ACCESS NAME: .USER.SOURCE 
REPLACE?: NO 

MOD LIST ACCESS NAME: <Press RETURN> 


9.3 ASSEMBLE THE PROGRAM 

1. Invoke the macro assembler by entering XMA command and select the following 
parameters: 

[]XMA 

EXECUTE MACRO ASSEMBLER 
SOURCE ACCESS NAME: .USER.SOURCE 
OBJECT ACCESS NAME: .USER.OBJECT 
LISTING ACCESS NAME: .USER.LISTING 
ERROR ACCESS NAME: .USER.ERROR 
OPTIONS: SYMT 

MACRO LIBRARY PATHNAME: <Press RETURN> 

PRINT WIDTH (CHARS): 80 
PAGE LENGTH (LINES): 60 

2. Enter the Wait command. 

[ ] WAIT 

—WAITING FOR BACKGROUND TASK TO COMPLETE— 

3. When the assembly completes, the following message is displayed: 

I ASSEMBLER-0001 MACRO ASSEMBLY COMPLETE, 0000 ERROR(S) 0000 
WARNING(S) 

4. Press the RETURN key to return to the command mode. 
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9.4 LINK EDIT THE OBJECT CODE 

1. First create a command file for the Link Editor. Invoke the Text Editor by entering XE 
command. Press the TAB key to clear the display. 

[]XE 

INITIATE TEXT EDITOR 
FILE ACCESS NAME: <Press TAB key> 

2. Place the Text Editor in compose mode by pressing F7 and then press the unlabeled 
gray key for the first blank line above the EOF* record. 

3. Enter the following lines into the control file: 

TASK TEST 

INCLUDE .USER.OBJECT 
END 

4. Leave the compose mode by pressing the CMD key. 

5. Quit the Text Editor by entering QE. Select the following parameters: 

[]QE 
QUIT EDIT 

ABORT?: NO 


QUIT EDIT 

OUTPUT FILE ACCESS NAME: 

REPLACE?: 
MOD LIST ACCESS NAME: 


.USER.CNTRLINK 

N 

<Press RETURN> 


6. Invoke the Link Editor by entering the Execute Link Editor (XLE) command. Select the 
following parameters: 

[]XLE 


EXECUTE LINK EDITOR 
CONTROL ACCESS NAME 
LINKED OUTPUT ACCESS NAME 
LISTING ACCESS NAME 
PRINT WIDTH (CHARS) 


.USER.CNTRLINK 
.USER.LNKOUT 
.USER.LNKLIST 
80 <Press RETURN> 


7. The SCI prompt [] appears, enter the WAIT command and press RETURN key. The 
following display appears: 


[ ] WAIT 


—WAITING FOR BACKGROUND TASK TO COMPLETE— 


9-4 


2270508-9701 


Assembly Language Program Example 9.5 


When the Link Editor terminates, the.foiiowing is dispiayed: 
i LiNKER-0001 LiNK EDiTOR COMPLETED, 0 ERROR(S), 0 WARNING(S) 
8. Press the CMD key to return to command mode. 


9.5 INSTALL THE PROGRAM 

The program must now be instalied as a DNOS task by use of the instaii Task (iT) command. A pro- 
gram fiie is required for the iT command. The .USER.PROGA program fiie created in Section 6, can 
be used in this exampie. Perform the foiiowing steps to instaii the task: 

1. Enter the iT command to piace the program on .USER.PROGA program fiie. Specify the 
foliowing parameters; 

[]IT 

INSTALL TASK SEGMENT 
PROGRAM FILE OR LUNO: .USER.PROGA 
TASK NAME: TEST 
TASK ID: 0 

OBJECT PATHNAME OR LUNO: .USER.LNKOUT 
PRIORITY: 4 

DEFAULT TASK FLAGS?: YES 
ATTACHED PROCEDURES: NO 

The installed ID is displayed in the following form when the installation is completed: 

TASK NAME = TEST 
TASK ID = >run-time ID 

2. Press the CMD key to return to the command mode. 

3. The program uses LUNO >20 and the LUNO must be assigned to either the VDT or the 
file .USER. MESSAGE. For the first examples the LUNO is assigned to .USER. MESSAGE. 
Call the Assign Luno (AL) command and respond as follows: 

[] AL 

ASSIGN LUNO 


LUNO 
ACCESS NAME 
PROGRAM FILE? 


>20 

.USER.MESSAGE 

NO 


The message ASSIGNED LUNO: >20 is then displayed. 

4. Press the CMD key to return to the command mode. 
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9.6 EXECUTE THE PROGRAM — SYMBOLIC DEBUGGING WITH SIMULATION 

Symbolic debugging involves the use of the Symbol Table. During the XMA command, the 
OPTIONS: SYMT must be entered to include the Symbol Table in the object code. Inclusion of the 
Symbol Table allows you to reference addresses by the label name rather than the address on any 
SCI command where an address is required, such as SP and AB. An example of the object code 
containing the Symbol Table information is shown in Figure 9-1. 

Notice the tag character, address, and label are presented at the bottom of the code. For example, 
G012ECLOSE 
To execute the program: 

1 . Use the Execute and Halt Task (XHT) command. Use of this command activates the task 
but does not begin execution. When XHT is entered, the following prompt is displayed. 
Respond as shown: 

[]XHT 

EXECUTE AND HALT TASK 
PROGRAM FILE NAME OR LUNO: .USER.PROGA 
TASK NAME OR ID: TEST 
PARM1: 0 
PARM2: 0 
STATION ID: ME 

The following message appears: 

RUNTIME TASK ID = >run-time ID 

2. Note that the run-time ID of the task is returned on the display. Remember the run-time 
ID for the next step. Return to the command mode. 


00 1 5CR ESP0NSEA0000C0006C0 1 3CB0000 A0006A0026DOOOOB0020BOOOOB00007F2 1 1 F RESPOOO 1 

B0000B0000B0000B0B20B0000C003EB0000B004AB0A0DB4845B4C4CB4F2CB20507F1CFF RESP0002 
B4C45B4153B4520B494EB5055B5420B4E55B4D42B4552B204FB4620B4954B454D7F187F RESP0003 
B5320B534FB4C44B2054B4F44B4159B2E20B2055B5345B2034B2D44B4947B49547F199F RESP0004 
B204EB554DB4245B5253B2E00A0086B0A0DB0000B0B20B0040C00A8B0000B000A7F1C8F REBP0005 
C0096C009CB0004B0000A009CA00A8B0A0DB4954B454DB2031B2020B0000B0B207F1D1F RESP0006 
B0040C00C6B0000B000AC00C0C00A0B0004B0000B0A0DB4954B454DB2032B20207F1EFF RESP0007 
B0000B0B20B0040C00E4B0000B000AC00DEC00A2B0004B0000B0A0DB4954B454D7F1CEF RESPOOOS 
B2033B2020B2000AOOFOBOOOOBOB20BCOOOCOOFCBOOOOB0032BOAODB 5448B4 1 4E7F 1 F 1 F RESP0009 
B4B20B594FB5520B464FB5220B594FB5552B2050B5552B4348B4153B452EB20487F197F RESPOOlO 
B4T56B4520B4120B4E49B4345B2044B4159B2EOOA012CBOA0DB0OO0B0120B00007F1E6F RESPOOll 
B0000B0000B0000B0400B2FE0C0026B2FE0C0032B2FE0C0088B2FE0C00B2B2FE07F195F RESP0012 
C00D0B2FE0C00F0B2FE0C012EB2FE0C013A7F7D9F RESP0013 

0012ECL0SE G013AE0P 000FCG00DBY0003EGREET G00A8ITEM1 7F26AF RESP0014 

G00C6ITEM2 G00E4ITEM3 G0032MSSG0 G0088MSSG1 G00B2MSSG2 7F2A7F RESP0015 

G00D0MSSG3 G00F0MSSG4 G00260PEN 2013CG013CSTART G009CST0RE 7F150F RESP0016 

G0096STR1 G00C0STR2 G00DESTR3 G0006WSP 7F5C1F RESP0017 

RESPONSE RESPOOIS 


Figure 9-1. Object Code with Symbol Table 
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3. Place the task in the debug mode by entering the Execute Debug (XD) command. Res- 
pond to the following prompts (answer NO to the 990/12 OBJECT CODE, if using 990/10 
system.), as shown: 

[]XD 

EXECUTE IN DEBUG MODE 

RUN ID: >run-time ID 

SYMBOL TABLE OBJECT FILE: .USER.LNKOUT 
990/12 OBJECT CODE?: YES 

4. The contents of the panel appear. 

5. Assimulated breakpoints may be assigned to aid in debugging by entering the ASB 
command, as follows: 

[]ASB 

ASSIGN SIMULATED BREAKPOINT 

ON (A,C,P,R,S): PC (default) 

FROM: >14E 
THRU: >14E 
COUNT: 1 
DISPLAY: 

The panel display and message SIMULATED BREAKPOINT 1 appear. Press the 
RETURN key. 

6. To begin execution of the task, use the Simulate Task (ST) command. The prompts and 
responses are as follows: 

[1ST 

SIMULATE TASK 

FOR: 100 

FROM: <Press RETURN> 

TO: <Press RETURN> 

The panel display for address >14E appears on the screen, with the message STOP AT 
TRAP #1. Press the CMD key to return to the command mode. 

7. To exit the debug mode, enter the Quit Debug (QD) command and respond as below: 

[]QD 

QUIT DEBUG MODE 

KILL TASK?: NO <Press RETURN> 
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8. To resume execution from the breakpoint enter the Resume Task (RT) command as 

shown below: ’ 

[] RT 

RESUME TASK 

RUN ID: >run-time ID <Press RETURN> 

9. The test program has executed. Perform a Show File (SF) command on the file 
.USER. MESSAGE. The following messages appear in the file. 

GOOD MORNING, PLEASE INPUT NUMBER OF ITEMS SOLD TODAY USE 4-DIGIT 
NUMBERS. 

ITEM 1 
ITEM 2 
ITEM 3 

THANK YOU FOR YOUR PURCHASE. HAVE A NICE DAY. 

Press the CMD key to return to the command mode. 

10. Execute the Release Luno (RL) command, to release LUNO >20 assigned to 
.USER. MESSAGE, as shown below: 

[] RL 

RELEASE LUNO 

LUNO: >20 

11. Delete file .USER. MESSAGE with the Delete File (DF) command, as shown below: 

[]DF 

DELETE FILE 

PATHNAME(S): .USER.MESSAGE 


9.7 EXECUTE THE PROGRAM — BREAKPOINT DEBUGGING 

In this example, the RESPONSE program Is debugged using assigned breakpoints, and the 
responses are written to USER.MESSAGE file. 

1. Create the .USER.MESSAGE file and assign LUNO >20 to the file, as shown above. 
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2. To execute the task, use the XHT command. Use of this command activates the task but 
does not begin execution. The XHT command is usefui when the debugging commands 
are to be used for the task. When XHT is entered, the foilowing prompt is displayed. 
Respond as shown: 

[] XHT 


EXECUTE AND HALT TASK 


PROGRAM FILE NAME OR LUNO 
TASK NAME OR ID 
PARM1 
PARM2 
STATION ID 


.USER.PROGA 

TEST 

0 

0 

ME 


The following message appears: 

RUNTIME TASK ID = >run-time ID 

3. Note that the run-time ID of the task is returned on the display. Remember the run-time 
ID for the next step. Return to the command mode. 

4. To assign breakpoints and stop execution of the task at location >146, enter the Assign 
Breakpoints (AB) command. Respond to the following prompts as shown: 

[] AB 

ASSIGN BREAKPOINTS 

RUN ID: >run-tlme ID 
ADDRESS(ES): >146 

The panel showing the address values of the WORKSPACE REGISTERS, BREAK- 
POINTS (0146), and MEMORY appear on the screen. A panel display similar to the one in 
Figure 9-2 appears: 
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Figure 9-2. Panel Display 
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5. Enter the RT command to reach the specified assigned breakpoint in the program. The 
following appears on the screen; 

[]RT 

RESUME TASK 

RUN ID: >run-time ID <Press RETURN> 

6. Task execution begins. 

7. To display memory contents of the assigned breakpoint, the Show Panel (SP) command 
or the Show Internal Registers (SIR) is entered. In this example the SP command is 
used. Respond to the prompts as follows: 

[]SP 

SHOW PANEL 

RUN ID: >run-tlme ID 
MEMORY ADDRESS: >146 

The panel values for address >146 appear on the screen in the section MEMORY. 

8. To resume execution of the task, the Proceed from Breakpoint (PB) command must be 
entered. The following prompts appear: 

[]PB 

PROCEED FROM BREAKPOINT 

RUN ID: >run-tlme ID 

DESTINATION ADDRESS(ES): <Press RETURN> 

9. Execution is complete. View the .USER.MESSAGE file with the SF command. The 
following appears in the file: 

GOOD MORNING, PLEASE INPUT NUMBER OF ITEMS SOLD TODAY. USE 4-DIGIT 
NUMBERS. 

ITEM 1 
ITEM 2 
ITEM 3 

THANK YOU FOR YOUR PURCHASES. HAVE A NICE DAY. 

10. Press the RETURN key to enter the command mode. 

11. Execute the RL command to release LUNO >20 assigned to .USER.MESSAGE and 
delete the file. 


9.8 EXECUTE THE PROGRAM - NO DEBUGGING 

This method is used when the task has previously been debugged and is ready to execute. 
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1. Assign LUNO >20 to the terminal with the AL command, as shown below; 
[] AL 

ASSIGN LUNO 


LUNO: 

>20 

ACCESS NAME: 

ME 

PROGRAM FILE?: 

NO 


The message ASSIGNED LUNO: >20 appears. Return to the command mode. 

2. Execute the program using the Execute Task and Suspend SCI (XTS) command. Select 
the following parameters: 

[]XTS 


EXECUTE TASK AND SUSPEND SCI 


PROGRAM FILE OR LUNO 
TASK NAME OR ID 
PARM1 
PARM2 
STATION ID 


.USER.PROGA 

TEST 

0 

0 

ME 


3. The test program now executes. The greeting and ITEM 1 appear. Enter a four-digit 
number in response. The next ITEM # appears after the four-digit response is complete. 
Enter another 4-digit number for all ITEM # prompts (1 through 3). The closing message 
appears. Below is an example of what appears: 

= = FOREGROUND COMMAND EXECUTING = = 

GOOD MORNING, PLEASE INPUT NUMBER OF ITEMS SOLD TODAY. USE 4-DIGIT 

NUMBERS. 

ITEM 1 2571 

ITEM 2 3123 

ITEM 3 4619 

THANK YOU FOR YOUR PURCHASE. HAVE A NICE DAY. 

4. After the closing message, the RUNTIME TASK ID = >run-time ID appears on the 
screen. 

5. Press the CMD key to return to the initial SCI menu. 

6. Delete the task entry by using the Delete Task (DT) command as follows: 

[] DT 

DELETE TASK 

PROGRAM FILE OR LUNO: .USER.PROGA 
TASK NAME OR ID: TEST 
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9.9 DELETE DIRECTORY 

To delete the directory .USER from the system disk, enter the Delete Directory (DD) command, as 
shown below: 


[JDD 

DELETE DIRECTORY 

PATHNAME: .USER 

LISTING ACCESS NAME: <Press RETURN> 

ARE YOU SURE: YES 

The directory created and all files in it are now deleted. Return the terminal to the command 
mode. 
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Appendix A 

Abnormal Completion Messages 


The following messages are issued by the assembler upon abnormal completion of processing. In 
addition to these messages, a number of messages are issued to the user in the assembly listing 
file and/or in the file specified in response to the ERROR ACCESS NAME prompt of the XMA 
procedure. 

The codes listed below are defined in the DNOS Messages and Codes Reference Manual. 

Message 

SOURCE FILE I/O ERROR, CODE = XXXX 
OBJECT FILE I/O ERROR, CODE = XXXX 
LIST FILE 1.0 ERROR, CODE = XXXX 
TEMP FILE 1.0 ERROR, CODE = XXXX 

The messages listed below are assembler bugs. If the message reappears on subsequent 
assemblies, load a fresh copy of the assembler from a backup disk. If the error still persists, con- 
tact your customer representative. 


Assembler Bugs 

ATTEMPT TO POP EMPTY STACK — SDSMAC BUG 
DIRECTIVE EXPECTED — SDSMAC BUG 
UNEXPECTED END OF PARSE — SDSMAC BUG 
ERROR MAPPING PARSE — SDSMAC BUG 
INVALID OPERATION ENCOUNTERED — SDSMAC BUG 
NO OP CODE — SDSMAC BUG 
INVALID LISTING ERROR ENCOUNTERED 
SYMBOL TABLE ERROR 
MACRO EXPANSION ERROR 
BUG — INVALID SDSLIB COMMAND ID 
UNKNOWN ERROR PASSED, CODE = XXXX 
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Appendix B 

Completion Messages 


The following messages are issued by the assembler upon completion of processing. In addition 
to these messages, a number of messages are issued to the user in the assembiy listing fiie 
and/or in the file specified in response to the ERROR ACCESS NAME prompt of the XMA 
procedure. 

For this set of messages, the internai message code and the message ID in this manuai are 
identicai. 

I ASSEMBLR-0001 MACRO ASSEMBLY COMPLETE, ?1 ERROR(S), ?2 WARNING(S) 

Expianation: 

The macro assembier has compieted normally, although there may have been errors or warn- 
ings generated from the source code. 

User Action: 

No action is required. 

USH ASSEMBLR-0002 MACRO ASSEMBLY ABNORMAL TERMINATiON 
Explanation: 

The macro assembler has terminated before compieting the assembly of the source code. 
The exact nature of the error is expiained by the message in the file specified in response to 
the ERROR ACCESS NAME prompt. 

User Action: 

The action to take depends on the message in the file specified in response to the ERROR 
ACCESS NAME prompt. 

US ASSEMBLR-0003 MEMORY REQUiRED EXCEEDS SYSTEM CAPACITY 
Explanation: 

The macro assembier was unabie to secure enough memory to complete the requested 
assembly. If there are any source lines in the fiie specified in response to the LiSTiNG 
ACCESS NAME prompt, the assembler was unable to complete the cross reference. 

User Action: 

If the system memory is reiativeiy smaii, it may heip to run the assembly when the system is 
less busy. If there is no shortage of physical memory, reduce the memory requirements of 
the program. The major items that use memory are macros and symbols. If the program con- 
tains macros that have no parameters or other macro variabies, consider replacing the 
macro caiis by source iines which are brought into the progam using a COPY statement. If 
the program contains macros with large amounts of text, assemble the macros into a macro 
library and use the LIBiN statement or provide a library pathname for the MACRO LIBRARY 
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PATHNAME prompt. If the program has many symbols, break it into two or more parts (using 
the REF command for references between parts) and use the Link Editor to combine the 
parts. 

USH ASSEMBLR-0004 END ACTION TAKEN BY MACRO ASSEMBLER 
Explanation: 

The macro assembler was forced to the end action address either by executing an instruc- 
tion that caused a task error or by the user killing the task. 

User Action: 

If the end action was not forced by user action, call a customer representative for 
assistance. 

USH ASSEMBLR-0005 ERROR ATTEMPTING TO OPEN THE SPECIFIED ERROR ACCESS NAME 
Explanation: 

The macro assembler was unable to open the file specified for the ERROR ACCESS NAME 
prompt. 

User Action: 

Check the response to ERROR ACCESS NAME to be sure the syntax is correct and that all 
directories in the pathname exist. If this does not correct the problem, call a customer 
representative for assistance. 

USH ASSEMBLR-0006 ERROR ATTEMPTING TO ACCESS SYNONYMS 
Explanation: 

The macro assembler received an error from the SCi routine S$GTCA. 

User Action: 

This is an unexpected internal error. Call a customer representative for assistance. 
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Error Listing Messages 


This appendix contains a iist of error and warning messages produced by the assembler. Error 
messages are printed in the listing file, when an error is detected, with the statement where the 
error occurred. Warning error messages are written only to the error file and are not included in 
the listing. A dash is placed in column eleven of the listing where the warning error occurred. 
Warning messages do not include an indication of a previous warning or error. Note that a warn- 
ing is a dash (-) in column II of the assembled program listing. 


Error Message 

Absolute value required. 

Attempt to index by 
register zero. 

Bad access name syntax. 

’CEND’ assumed. 

Close ( ”)” ) missing. 

Comma missing. 

Common table overflow. 

Conditional assembly 
nesting error. 


’□END’ assumed. 
Directory open error. 

Directory read error. 

Directory required. 


Possible Causes 


A warning 

A warning 
A warning 


Too many common segments used (127 maximum). 

An if-then-eise construct is in error. Conditions which could 
cause this are: 

a. Missing ASMEND’S 

b. Surplus ASMEND’S 

c. Surplus ASMELS’S 

A warning. 

Check that any synonyms are valid and that no other pro- 
cessor is currently writing to the MARCO library. 

An I/O error was encountered while trying to read a macro 
library Directory. Verify that no other processor is currently 
writing to that macro library. 

The access name specified is not an existing directory. 
Verify that all synonyms are correct and that the macro 
library does indeed exist; it can not be auto-created. 
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Error Message 

Possible Causes 

Directory write error. 

Verify that no other processor is currently writing to that 
macro library. 

Displacement too big. 

An instruction requiring an operand with a fixed upper limit 
was encountered which overflowed this limit. An example is 
the ’JMP’ instruction, whose single operand must evaluate 
to within >7F words distance from the current program 
counter. 

’DSEG’ assumed. 

This is a warning that the following two statements have the 
same result: 


CSEG ’ $DATA’ 

DSEG 

Duplicate definition. 

a. The symbol appears more than once in the label field of 
the source. 

b. The symbol appears as an operand of a REF statement 
as well as In the label field of the source. 

c. An attempt was made to define a macro variable or 
macro language label which was previously defined in 
the macro. 

Error expanding call. 

The symbol in the operand field of the $CALL statement is 
not a defined macro. 

Error on copy open. 

The access name specified as the operand of copy directive 
can not be opened. Check that the synonyms are correct 
and that the file Is not currently being written to by another 
processor. 

Expression syntax error. 

a. Unbalanced parentheses. 

b. Invalid operations on relocatable symbols. 

Indirect (*) missing. 


Invalid $ASG variable. 

a. An attempt was made to change the length component 
of a variable. 

b. An attempt was made to change the attribute com- 
ponent or the value component of a macro variable 
which was declared as a macro language label. 

c. The target variable is not present or is not a symboi. 

Invalid character in 
symbol - blank used. 

A warning (Note 1). The legal characters to be used in 
symbols under SDSMAC are A-Z, 0-9, and ”$”. 

Invalid Condition 

The List Search instructions require conditions to be 
specified as one of the operands. The following are legal 
conditions: EQ, NE, HE, L, GE, LT, LE, H, LTE, GT. 
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Error Message 

Invalid CRU or shift 
value. 

Invalid directive in 
absoiute code. 

Invalid expression. 

Invalid macro 
expression. 

Invalid macro variable. 

Invalid model statement. 

Invalid opcode. 

Invaiid option. 


invalid relocation 
type. 

Invaiid use of 
conditionai assembiy. 

invalid use of REF’d 
symbol. 

Invalid $ASG expression. 

Invalid $IF expression. 


Label required. 


Possible Cause 


A warning 


The directives PEND, DEND, CEND have no meaning in 
absolute code. 

May indicate invalid use of a relocatable symbol in 
arithmetic. 

Invalid construct in $ASG statement. 


The target variable specified on a $ASG or $GOTO verb is 
not a valid target variable. 

A macro symbol in a model statement must be followed 
with either a colon operator (:) or end-of-record. 

The second field of the source record contained an entry 
that is not a defined instruction, directive, pseudo-op, DX- 
OP, DFOP, or macro name. 

A warning. The only legal options are: 

XREF 
SYMT 
NOLIST 
MUNLST 
RXREF 

(or suitable abbreviation). 

Only PSEG relocatable or absolute symbols are allowed as 
the operand of an ‘END’ statement. 

A conditional assembly directive may not appear as a model 
statement. 

REF’d symbols may appear in expressions only under 
certain conditions (see the 990/10 manual). 

The expression is not present. 

The expression either is not present or does not evaluate to 
an integer value. 


TUNLST 

BUNLST 

DUNLST 

FUNL 
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Error Message 

Macro definition 
discarded due to 
errors. 

Macro iibrary read 
error. 


Macro iibrary write 
error. 


Macro string 
overflow. 

Macro symbol truncated. 


Max macro nesting stack 
depth overflow. 


Memory exceeded. 

Missing $END. 

Model statement 
truncated. 

Open ’(’ Missing 


Possible Causes 

An error was detected during the assembly of the macro 
definition. Use of the macro name in succeeding lines will 
cause error messages. 

A ’LIBIN’ was in effect and the statement was a macro in a 
specified macro library, but an I/O error was encountered 
when reading it. 

The current ’LiBOUT’ library could not be used at com- 
pletion of a macro definition. Check that the macro is not 
currently begin written by another processor. 

In building a concatenated string, the length of the string 
exceeded 225 characters. 

A warning. The maximum length for a macro symbol is two 
characters. The following are legal macro symbols: A, A.S, 
B2.SV. 

The following are illegal macro symbols: CNT, CNT.A, 
PM2.SL. 

a. A macro calls Itself recursively more than the allowed 
maximum number of times. 

b. More levels of macro calling have been used than the 
allowed maximum. 

The program counter overflowed the value >FFFF. 


A warning. When expanded, the model statement exceeded 
80 characters in length. 

A parenthesized operand is required with the Extract Field, 
Extract Value, Insert Field, and Invert Order of Field Insert 
instruction. 
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Error Message 

Operand conflict PASS1/ 
PASS2. 


SUB 


SUB 

Operand missing. 


’PEND’ assumed. 

Register required. 

String required. 

String truncated. 

Symbol truncated. 

Symbol required. 

Symbol used in both REF 
and DEF. 

Syntax error. 

’TO’ missing. 


Possible Causes 

During pass 1, the assembler defaults currently undefined 
symbols as register names if that symbol is used in an 
ambiguous way, as shown in the example below. If during 
the pass 2 it is discovered that the symbol was not a register 
name, this error results. 

An example is: 


BL SUB 


EQU $ 

If this example had been coded as follows, no ambiguity 
would have existed due to the explicit sign: 

BL @SUB 


EQU $ 

On instructions having a fixes number of operands, too few 
appeared before encountering a blank. On instructions hav- 
ing a variable number of operands, such as ’DATA’, a com- 
ma may have been encountered with no operand following 
it. An expression extending beyond the 60th column could 
cause this problem. 

A warning. 


A warning. Check the syntax for the directive in question to 
determine the maximum length for the string. 

A warning. The maximum length for a symbol is six 
characters. 


This is a conflicting, duplicate definition. 


’TO’ is a required part of the syntax for the $ASG Macro 
verb. 
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Error Message 

Undefined macro 
variable. 

Undefined symbol. 

Valid opcode required. 


Value truncated. 


Workspace address not 
previously defined. 


$IF-$ELSE-$ENDIF 
construct in error. 


$MACRO invalid within 
macro definition. 


Possible Causes 

The target variable specified on a $ASG or $GOTO verb is 
undefined. 

a. A symbol is used which did not appear in the label field 
of a source record. 

b. The symbol must be defined for the first pass. 

The defining symbol (i.e., the second operand) is not a valid 
instruction or directive. 

A warning. Overflow is checked after every operation in an 
arithmetic expression. This may result in several trunca- 
tions in one expression. 

The operand field must have been previously defined. Note 
that the WPNT directive (or implied WPNT) is ignored. Any 
previous WPNT is also ignored from this point on. 

Possible errors are: 

a. Surplus $ELSEs. 

b. Surplus $ENDIFs. 

c. Missing $ENDIFs. 

a. The $END verb belonging to the previous macro was 
missing. 

b. A $MACRO verb was unintentionally included. 
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HOW TO USE INDEX 

The index, table of contents, list of illustrations, and list of tables are used in conjunction to ob- 
tain the location of the desired subject. Once the subject or topic has been located in the index, 
use the appropriate paragraph number, figure number, or table number to obtain the corre- 
sponding page number from the table of contents, list of illustrations, or list of tables. 

INDEX ENTRIES 

The following index lists key words and concepts from the subject material of the manual together 
with the area(s) in the manual that supply major coverage of the listed concept. The numbers along 
the right side of the listing reference the following manual areas: 

• Sections — Reference to Sections of the manual appear as “Sections x” with the sym- 
bol X representing any numeric quantity. 

• Appendixes — Reference to Appendixes of the manual appear as “Appendix y” with the 
symbol y representing any capital letter. 

• Paragraphs — Reference to paragraphs of the manual appear as a series of 
alphanumeric or numeric characters punctuated with decimal points. Only the first 
character of the string may be a letter; all subsequent characters are numbers. The first 
character refers to the section or appendix of the manual in which the paragraph may be 
found. 

• Tables — References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number. 

Tx-yy 

• Figures — References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number. 

Fx-yy 

• Other entries in the Index — References to other entries in the index preceded by the 
word “See” followed by the referenced entry. 
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Index 


AB Command 8.3.3. 1 , 9.7 

Abnormal Termination, Task 3.4.2 

Absolute: 


Address .... 5.2.4.1 , 8.3.1 .5, 8.3.2.1 , 8.3.2.6 

Data Word 5.2.4.4 

Access Name Definition 2.5 

Account ID Prompt 2.3.2 

Activate Task 8.3.4.3 

Activate Task (AT) Command . . 8.3.4.1 , 8.3.4.3 

Activating SCI 2.3.2 

Address: 


Absolute 5.2.4.1 , 8.3.1 .5, 8.3.2.1 , 8.3.2.6 


Bus 3.2 

Entry 5.2.4.1, 5.2.4.4 

Load 5.2.4.1,5.2.4.4 

Relocatable 5.2.4.1, 5.2.4.4 

Space: 

Logical 3.2 

Physical 3.2 


ADU. 8.3.1. 6, 8.3.2.2 

AL Command 2.8.2.3, 2.8.4, 9.5, 9.8 

Allocatable Disk Unit (ADU) . . .8.3.1.6, 8.3.2.2 

ALN Command 2.6.2 

Arithmetic Overflow Task 

Attributes 3.11.10, 5.2.2, 6.8.1 

AS Command 2.6.1 


ASB Command 8.3.6.1, 8.3.6.2, 8.3.6.3, 9.6 


Assembler: 

Cross-Reference Listing 5.1 

Error Message 5.2.2 

Listing Option 5.1 

Operation 5.1 

Batch Mode 5.3 

Option: 

BUNLST 5.1 

DUNLST 5.1 

FUNL 5.1 

MUNLST 5.1 

NOLIST 5.1 

RXREF 5.1 


Symbol Table 5 

SYMT 

TUNLST 

XREF 

990/12 

Output Option 

SDSMAC 

Warning Messages 

Assembling Programs 

Assembly Example 

Assembly Language: 

Concepts 

DNOS 

Program Example 

Assign Breakpoint 

Assign Breakpoint (AB) 

Command 

Assign Logical Name (ALN) 
Command 


.1,5.2.4.1,5.2.4.3 
5.1,5.2.4.3, 8.2.2, 
8.3.4.4, 9.1, 9.6 

5.1 

5.1 

5.1 

5.1 

1.1 

5.2.2 


,...1.3, 9.3 
9.3 

3.1 

1.1 

. .9.1, F4-1 
. . . .8.3.3.4 

8.3.3.1,9.7 

2.6.2 


Assign LUNO (AL) 

Command 2.8.2.3, 2.8.4, 9.5, 9.8 

Assign LUNO SVC 2.8.4 

Assign Simulated Breakpoint (ASB) 

Command 8.3.6.1, 8.3.6.2, 8.3.6.3, 9.6 

Assign Synonym (AS) Command 2.6.1 

AT Command 8.3.4.1, 8.3.4.3 

Attributes 3.10 

Symbol T5-1 

Automatic Overlay Manager 3.9.2 

Background Task 2.2.1, 2.3.5 

BATCH Command 2.3.5. 1, 5.3.1 

Batch: 

Command Format 2.3.5.2 

Job 2.2.2 

Interactive Execution 2.3.5.3 

Mode 2.2.2, 2.3.5 

Assembler Operation 5.3 

Stream: 

Card Reader 5.3.4, F5-9 

Example F5-8 

Execution 7.4, F7-1 

Format 2.3.5.1 

Interactive Execution 2.3.5.3 

Structure 5.3.1 

Bias, Load 5.2.4. 1 , 5.2.4.4 

BIND Instruction 4.6 

BL Instruction 4.6 

BLSK Directive 4.6 

BLWP Instruction 4.6 

Boundary, Word 8.3.5.2 

Branch and Link (BL) Instruction 4.6 

Branch and Load Workspace 

Pointer (BLWP) Instruction 4.6 

Branch and Push Link to Stack 

(BLSK) Directive 4.6 

Branch Indirect (BIND) Instruction 4.6 

Breakpoint 8.3.1. 1, 8.3.3 

Debug Commands 8.3.3 

Debugging Example, Execute 9.7 

Simulated 8.3.6.1 

BUNLST Assembler Option 5.1 

Bus, Address 3.2 

BYTE Directive 5.1 

Call Techniques, Subroutine 4.6 

Card Reader Batch Stream 5.3.4, F5-9 

CFDIR Command 4.5.1 

CFPRO Command 6.8 

CFSEQ Command 9.5 

Channel: 

Global 2.8.2.3 

IPC 2.8.2.2 

Job-Local 2.8.2.3 

Master/Slave 2.8.2.2 

Scope 2.8.2.3 

Symmetric 2.8.2.2 

Task-Local 2.8.2.3 

Character String 8.2.3 
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Checksum 5.2.4.1 , 5.2.4.4 

CIC Command 2.8.2 

Class Type, Device 2.8.5 

Command: 

AB 8.3.3.1,9.7 

Activate Task (AT) 8.3.4.1, 8.3.4.3 

AL 2.8.2.3, 2.8.4, 9.5, 9.8 

ALN 2.6.2 

AS 2.6.1 

ASB 8.3.6.1 , 8.3.6.2, 8.3.6.3, 9.6 

Assign Breakpoint (AB) 8.3.3.1, 9.7 

Assign Logical Name (ALN) 2.6.2 

Assign LUNO (AL) .... 2.8.2.3, 2.8.4, 9.5, 9.8 
Assign Simulated Breakpoint 

(ASB) 8.3.6.1,8.3.6.2, 8.3.6.3,9.6 

Assign Synonym (AS) 2.6.1 

AT 8.3.4.1,8.3.4.3 

BATCH 2.3.5.1, 5.3.1 

CFDIR 4.5.1 

CFPRO 6.8 

CFSEQ 9.5 

CIC 2.8.2 

Compressed Tagged Object 

FORMAT 6.7.2 


Create Directory File (CFDIR) . . 2.4.2, 4.5.1 

Create File Sequential (CFSEQ) 9.5 

Create I PC Channel (CIC) 2.8.2 

Create Program File (CFPRO) 6.8 

DB 8.3.3.1,8.3.3.2 

DD 9.9 

Delete and Proceed from 


Breakpoint (DPB) 8.2, 8.3.3.1, 

8.3.3.3, 8.3.4.3 

Delete Breakpoints 

(DB) 8.3.3.1,8.3.3.2,8.3.4.3 

Delete Directory (DD) 9.9 

Delete File(DF) 9.6 

Delete Overlay (DO) 6.8.8 

Delete Procedure (DP) 6.8.7 

Delete Program Segment (DPS) 6.8.9 

Delete Simulated Breakpoints 


(DSB) 8.3.6.2 

Delete Task (DT) 3.11.4,6.8.6,9.8 

DF 9.6 

Displays T8-2 

DO 6.8.8 

DP 6.8.7 

DPB 8.2, 8.3.3.1,8.3.3.3,8.3.4.3 

DPS 6.8.9 

DSB 8.3.6.2 

DT 3.11.4, 6.8.6, 9.8 

DUMY 6.3 

EBATCH 2.3.5.1, 5.3.1 

Entry, SCI 2.3.3 


Execute and Halt Task 

(XHT) 7.2.3, 8.2.1 , 8.3.4.4, 8.3.4.5, 9.6 

Execute Batch Job 


(XBJ) 2.3.5, 2.3.5.3, 5.3.3 

Execute Batch (XB) 2.3.5, 2.3.5.3, 5.3.2 

Execute COBOL Task (XCT) 2.3.1 


Execute in Debug Mode 

(XD) 8.2, 8.2.1, 8.2.2, 8.3.4.4 

Execute Link Editor (XLE) . . 2.3.5.2, 6.3, 9.4 
Execute Macro Assembler (XM A) . . 5.1 , 9.3 


Execute Pascal Task (XPT) 2.3.1 

Execute Task and Suspend SCI 
(XTS) 7.2.2, 9.8 


Execute Task (XT) 2.3.1, 7.2.1, 8.2.1 

Execute Text Editor (XE) . . .4.1, 4.5.1, 4.5.2 

Find Byte(FB) 8.3.5.1 

Find Word (FW) 8.3.5.2 

FORMAT 6.3, 6.7 

Format, Batch 2.3.5.2 

Halt Task (HT) 8.3.4.2, 8.3.4.3 

HT 8.3.4.2, 8.3.4.3 

IDS 2.4.1 

IMAGE: 


Format 6.7.3 

Format Link Editor 6.9 


INCLUDE 6.6.2, 6.6.3 

Initialize Disk Surface (IDS) 2.4.1 

Initialize New Volume (INV) 2.4.1 

Install Overlay (10) 6.8.4 

Install Procedure (IP) 3.10,6.6.2,6.8.3 

Install Program Segment (IPS) . . 3.10, 6.8.5 

Install Real-Time Task (IRT) 6.8.2 

Instali Task (IT) 3.10, 3.11.1, 6.6.2, 

6.7.3, 6.8.1, 9.5 


INV 2.4.1 

10 6.8.4 

IP 3.10,6.6.2,6.8.3 

IPS 3.10,6.8.5 

IRT 6.8.2 

IT 3.10, 3.1 1 .1 , 6.6.2, 6.7.3, 6.8.1 , 9.5 

KBT 3.4 

Kill Background Task (KBT) 3.4 

Kill Task (KT) 3.4, 8.2.1 

KT 3.4, 8.2.1 

LB 8.3.1. 1 

LD 2.3.4.2 

List Breakpoints (LB) 8.3.1. 1 

List Directory (LD) 2.3.4.2 

List Logical Record (LLR) 8.3.1. 2 

List Memory (LM) 8.3.1. 3 

List Simuiated Breakpoints (LSB) . .8.3.6.3 

List System Memory (LSM) 8.3.1. 4 

LLR 8.3.1. 2 

LM 8.3.1. 3 

LOAD Link Edit 3.9.2 

LSB 8.3.6.3 

LSM 8.3.1. 4 

MAD 8.3.2.1 

MADU 8.3.2.2 

Memory Image FORMAT 6.7.3 

MIR 8.3.2.3 

MM 8.3.2.4 

Mode 4.3 

Modify Absolute Disk (MAD) 8.3.2. 1 

Modify Allocatable Disk Unit 
(MADU) 8.3.2.2 
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Modify Internal Registers (MIR) . . . .8.3.2.3 

Modify Memory (MM) 8.3.2.4 

Modify Overlay Entry (MOE) 6.8.12 

Modify Procedure Entry (MPE) 6.8.11 

Modify Program Image (MPI) 8.3.2.5 

Modify Relative to File(MRF) 8.3.2.6 

Modify Segment Entry (MSE) 6.8.13 

Modify Synonym (MS) 2.6.1 

Modify System Memory (MSM) 8.3.2.7 

Modify Task Entry (MTE) 6.8.10 

Modify Workspace Registers 

(MWR) 8.3.2.8 

MOE 6.8.12 

MPE 6.8.11 

MPI 8.3.2.5 

MRF 8.3.2.6 

MRW 8.3.2.8 

MS 2.6.1 

MSE 6.8.13 

MSM 8.3.2.7 

MTE 6.8.10 

Normal Tagged Object FORMAT 6.7.1 

PARTIAL Link Editor 6.7.1 

PB 8.2,8.3.3.1,8.3.3.3, 

8.3.3.4, 8.3.4.3, 8.3.6.4, 9.7 

PROCEDURE 3.8 

Proceed from Breakpoint 

(PB) 8.2,8.3.3.1,8.3.3.3, 

8.3.3.4, 8.3.4.3, 8.3.6.4, 9.7 

Q 4.3 

QD 8.2.1, 8.3.6.4, 9.6 

QE 4.1, 4.5.1, 4.5.2 

Quit Debug Mode (QD) . . . 8.2.1 , 8.3.6.4, 9.6 

QuitEdit(QE) 4.1, 4.5.1, 4.5.2 

Quit(Q) 4.3 

Release LUNO(RL) 9.8 

Replace String (RS) 4.5.2 

Resume Simulated Task 

(RST) 8.3.6.1,8.3.6.5,8.3.6.6 

Resume Task (RT) 8.2, 8.3.3.1 , 8.3.3.2, 

8.3.4.3, 8.3.4.5, 8.3.6.4, 9.6 

RL 9.8 

RS 4.5.2 

RST 8.3.6.1,8.3.6.5,8.3.6.6 

RT 8.2,8.3.3.1,8.3.3.2, 

8.3.4.3, 8.3.4.5, 8.3.6.4, 9.6 

SAD 8.3.1. 5 

SADU 8.3.1. 6 

SBS 2.3.4.1 

Selection 4.2 

SEM 2.10.2.1 

SF 9.6 

Show Absolute Disk (SAD) 8.3.1. 5 

Show Allocatable Disk Unit 

(SADU) 8.3.1. 6 

Show Background Status (SBS) .... 2.3.4.1 
Show Expanded Message (SEM) . .2.10.2.1 

Show File(SF) 9.6 

Show Internal Registers 

(SIR) 8.3.1.7,8.3.3.1,9.7 

Show Line (SL) 4.2 


Show Panel 

(SP) 8.3.1.8, 8.3.1.12, 8.3.3.1, 9.7 

Show Program Image (SPI) 8.3.1. 9 

Show Relative to File(SRF) 8.3.1.10 

Show Task Status (STS) 8.2.1, 8.3 

Show Value (SV) 8.3.1.11 

Show Workspace Registers 

(SWR) 8.3.1.12 

Simulate Task (ST) 8.3.6.5, 9.6 

SIR 8.3.1.7,8.3.3.1,9.7 

SL 4.2 

Snapshot Name Definitions (SND) . . 2.3.5.3 

SND 2.3.5.3 

SP 8.3.1.8, 8.3.1.12, 9.7 

SPI 8.3.1.9 

SRF 8.3.1.10 

ST 8.3.6.5,9.6 

STS 8.2.1, 8.3 

SV 8.3.1.11 

SWR 8.3.1.12 

TASK 6.6.2 

Link Edit 6.6.4 

Usage, SCI 4.3 

User-Defined 2.3.1 

XB 2.3.5, 2.3.5.3, 5.3.2 

XBJ 2.3.5, 2.3.5.3, 5.3.3 

XCT 2.3.1 

XD 8.2, 8.2.1, 8.2.2, 8.3.4.4 

XE 4.1, 4.5.1, 4.5.2 

XHT 7.2.3, 8.2.1 , 8.3.4.4, 8.3.4.5, 9.6 

XLE 2.3.5.2, 6.3, 9.4 

XMA 5.1, 9.3 

XPT 2.3.1 

XT 2.3.1, 7.2.1, 8.2.1 

XTS 7.2.2, 9.8 

Commands: 

Breakpoint Debug 8.3.3 

Controlled; 

Debug 8.2 

Task 8.3.6 

Data: 

Display Debug 8.3.1 

Modification Debug 8.3.2 

Debug 8.2, 8.3, T8-1 

Link Editor 6.2, T6-1 

Search Debug 8.3.5 

Simulate Debug 8.3.6 

Task Control Debug 8.3.4 

Text Editor T4-1 

Common Segment 4.6, 5.2.4.1 

Common Segment (CSEG) Directive 4.6 

Common-Relocatable 5.2.4.1 

Communications 3.13 

Compressed Tagged: 

Object FORMAT Command 6.7.2 

Object Link Editor Output Format . . . .6.7.2 

Concatenated File 2.7.4 

Configuration, Task Memory F3-3 

Constants 8.2.3 

Symbolic 8.2.3 
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Control: 

Debug Commands, Task .8.3.4 

File, Link Editor 6.2 

Functions, Edit 4.2, 4.4, T4-2 

Control Storage Task Attributes 3.11.11 

Controlled: 

Debug Commands 8.2 

Execution 8.3.6.6 

Mode 8.2, 8.3.4.4, 8.3.6.4 

Task Commands 8.3.6 

Copies, Multiple 2.8.5 

Copyable Task Attributes . . 3.1 1 .7, 6.8.1 , 6.8.5 

Cover Page Example, Output F5-2 

Create Directory File (CFDIR) 

Command 2.4.2, 4.5.1 

Create File 2.4.3, 4.5.1 

Create File Sequential (CFSEQ) 

Command 9.5 

Create IPC Channel (CIC) Command 2.8.2 

Create IPC Channel SVC 2.8.2 

Create Logical Name SVC 2.7.4 

Create Program File (CFPRO) 

Command 6.8 

Create Segment SVC 3.10 

Cross-Reference Listing 5.2.3, F5-4 

Assembler 5.1 

CSEG Directive 3.8, 4.6 

DATA Directive 5.1, 6.9 

Data: 

Display 4.2 

Debug Commands 8.3.1 

Entry Operations 4.2 

Modification Debug Commands 8.3.2 

Relocatable 5.2.4.1 

Segment 5.2.4.1 

Data Segment (DSEG) Directive 4.6 

Data Word 5.2.4.1 , 5.2.4.4 

Absolute 5.2.4.4 

Relocatable 5.2.4.4 

DB Command 8.3.3.1, 8.3.3.2 

DD Command 9.9 

Debug: 

Commands 8.2, 8.3, T8-1 

Breakpoint 8.3.3 

Controlled 8.2 

Data Display 8.3.1 

Data Modification 8.3.2 

Search 8.3.5 

Simulate 8.3.6 

Task Control 8.3.4 

Mode 8.2, 8.3.4.4, 8.3.6.4 

Panel 8.3.1. 8, 8.3.3.2 

Symbolic 8.2.2 

Unconditionally Suspended 8.2 

Debugging 8.1 

Example: 

Execute Breakpoint 9.7 

Execute Symbolic 9.6 

Programs 1.6 

DEF Directive 4.6, 6.4.2, 6.4.4 


Default: 

Main Menu F2-1 

Program File 6.8 

Delete and Proceed from Breakpoint 

(DPB) Command 8.2, 8.3.3.1, 

8.3.3.3, 8.3.4.3 

Delete Breakpoints (DB) 

Command 8.3.3.1 , 8.3.3.2, 8.3.4.3 

Delete Directory (DD) Command 9.9 

Delete File (DF) Command 9.6 

Delete Overlay (DO) Command 6.8.8 

Delete Procedure (DP) Command 6.8.7 

Delete Program Segment (DPS) 

Command 6.8.9 

Delete Protected Task Attributes . . . .3.11.6.1 
Delete Simulated Breakpoints 

(DSB) Command 8.3.6.2 

Delete Task (DT) Command . .3.11.4, 6.8.6, 9.8 

Delete Task SVC 3.11.4 

Device: 

Class Type 2.8.5 

Display 8.4 

I/O 2.8.4,3.13.2 

Services 3.13 

DF Command 9.6 

Directive 5.2.1 

BLSK 4.6 

Branch and Push Link to Stack 

(BLSK) 4.6 

BYTE 5.1 

Common Segment (CSEG) 4.6 

CSEG 3.8, 4.6 

DATA 5. 1,6.9 

Data Segment (DSEG) 4.6 

DEF 4.6, 6.4.2, 6.4.4 

DSEG 3.8, 4.6 

EQU 4.6 

External Definition (DEF) 4.6, 6.4.2 

External Reference (REF) 4.6, 6.4.1 

IDT 4.6, 5.2.4.1, 6.4.1, 6.4.3, 8.2.2 

□ BIN 5.1 

LOAD 5.2.4.1 

Page Title (TITL) 4.6 

Program 6.4 

Program Identifier (IDT) 4.6, 6.4.3 

Program Segment (PSEG) 4.6 

PSEG 3.8, 4.6 

REF 4.6, 6.4.1, 6.4.4 

Secondary External Reference 

(SREF) 5.2.4.1 

SREF 6.4.1 

TEXT 5.1 

TITL 4.6 

Directory: 

File 2.4.2 

Structure 2.4, F2-2 

VCATALOG 2.4.2 

Disk-Based Segments 3.10 

Disk File 3.13.2 
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Disk-Resident: 

Memory Image 8.3.1.9 

Task 3.4.1 

Task Attributes 3.11.4 

Display: 

Data 4.2 

Debug Commands 8.3.1 

Device 8.4 

Panel F9-2 

Displays: 

Command T8-2 

Station-Dependent 8.4 

DNOS Assembly Language 1.1 

DO Command 6.8.8 

DP Command 6.8.7 

DPB Command .... 8.2, 8.3.3.1 , 8.3.3.3, 8.3.4.3 

DPS Command 6.8.9 

DSB Command 8.3.6.2 

DSEG Directive 3.8, 4.6 

DT Command 3.11.4,6.8.6,9.8 

DUMY Command 6.3 

DUNLST AssemblerOption 5.1 

DXOP Instruction 3.5 

EBATCH Command 2.3.5.1, 5.3.1 

Edit Control Functions 4.2, 4.4, T4-2 

Editing File 4.5.2 

End Action: 

Entry Point 3.6 

Routine 3.6 

End Action Status SVC 3.4.2 

End-of-Record 5.2.4.1 

End Task SVC 3.4.1 

Entering Programs 1.2, 2.3.5.4 

Entry: 

Address 5.2.4.1, 5.2.4.4 

Point, End Action 3.6 

SCI Command 2.3.3 

Vector 3.6 

EQU Directive 4.6 

Error Message 2.10.1 , 8.2.2, 8.3.3.1 

Assembler 5.2.2 

Online Expanded 2.10.2 

? Response 2.10.2.2 

Evaluation, Expression 8.2.3 

Execute and Halt Task 


(XHT) Command 7.2.3, 8.2.1, 

8.3.4.4, 8.3.4.5, 9.6 

Execute Batch Job (XBJ) 

Command 2.3.5, 2.3.5.3, 5.3.3 

Execute Batch (XB) 

Command 2.3.5, 2.3.5.3, 5.3.2 

Execute Breakpoint Debugging 

Example 9.7 

Execute COBOL Task (XCT) 

Command 2.3.1 

Execute in Debug Mode 

(XD) Command 8.2, 8.2.1 , 8.2.2, 8.3.4.4 

Execute Link Editor 

(XLE) Command 2.3.5.2, 6.3, 9.4 


Execute Macro Assembler 

(XM A) Command 5.1, 9.3 

Execute No Debugging 9.8 

Execute Pascal Task (XPT) Command . . 2.3.1 
Execute: 

Programs 1.5 

Protected Task Attributes 3.1 1 .6.2 

Symbolic Debugging Example 9.6 

Execute Task and Suspend SCI 

(XTS) Command 7.2.2, 9.8 

Execute Task (XT) 

Command 2.3.1, 7.2.1, 8.2.1 

Execute Text Editor (XE) 

Command 4.1, 4.5.1, 4.5.2 

Execution: 

Batch: 

Job, Interactive 2.3.5.3 

Stream 7.4, F7-1 

Stream, Interactive 2.3.5.3 

Controlled 8.3.6.6 

Interactive 7.4 

Program 7.1 

Simulated 8.3.6.6 

SVC Program 7.3 

Expanded Error Message, Online 2.10.2 

Expression: 

Evaluation 8.2.3 

Symbolic 8.2,8.3.4.4 

Expressions 8.3.1.11 

External Definition 5.2.4.1, 5.2.4.4 

External Definition (DEF) 

Directive 4.6, 6.4.2 

External Reference 5.2.4.1, 5.2.4.4, F5-6 

External Reference (REF) 

Directive 4.6, 6.4.1 

Field Prompt Notation T1-2 

File: 

Concatenated 2.7.4 

Create 2.4.3, 4.5.1 

Default Program 6.8 

Directory 2.4.2 

Disk 3.13.2 

Editing 4.5.2 

Format 5.2 

Image 6.7.3 

Installation, Link Editor Image 6.9 

I/O 2.8.3,3.13.2 

Key Indexed 2.7.3 

Link Editor Control 6.2 

Multivolume 2.7.4 

Program . . . 2.7.2, 3.9.3, 3.10, 6.7.3, 6.8, 6.8.1 

Relative Record 2.7.2 

Sequential 2.7.1 

Services 3.13 

System Image 6.7.3 

Type 2.7 

.S$SHARED Program 3.8,3.11.4,6.8 

.S$UTIL Program 3.11.4,6.8 

Find Byte (FB) Command 8.3.5.1 
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Find Word (FW) Command 8.3.5.2 

Foreground Task 2.2.1 

Format: 

Batch: 

Command 2.3.5.2 

Stream 2.3.5.1 

Command, IMAGE 6.7.3 

Compressed Tagged Object 

Link Editor Output 6.7.2 

File . . . 5 2 

IMAGE ' .’ .’ .' .' .' .‘ .’ .' .’ .’ .’ . S.gii, 6.3,' 6!8 

Link Editor Command, IMAGE 6.9 

Linked Object Code 6.7 

Machine Instruction 5.2.4.2, F5-7 

Memory Image Link Editor Output . . .6.7.3 
Normal Tagged Object Link Editor 

Output 6.7.1 

Object Code 5.2.4.1 

Object Record T5-2 

Output Option, Link Editor 6.7 

Selection 2.8.5 

FORMAT Command 6.3, 6.7 

Compressed Tagged Object 6.7.2 

Memory Image 6.7.3 

Normal Tagged Object 6.7.1 

Forms 2.8.5 

FUNL Assembler Option 5.1 

F3Key 8.3.6.1, 8.3.6.5 

Global: 

Channel 2.8.2.3 

LUNO 2.8.4 


Halt Task (HT) Command 8.3.4.2, 8.3.4.3 

Hardware Privileged Task 

Attributes 3.11.1.1 

HT Command 8.3.4.2, 8.3.4.3 


Identifier, Module 8.2.2 

IDS Command 2.4.1 

IDT Directive. . . .4.6, 5.2.4.1, 6.4.1, 6.4.3, 8.2.2 
Image: 

Disk-Resident Memory 8.3.1. 9 

File 6.7.3 

Installation, Link Editor 6.9 

System 6.7.3 

FORMAT Command, Memory 6.7.3 

Link Editor Output Format, Memory . .6.7.3 

Memory 8.3.2.4 

Program 8.3.2.5 

IMAGE Format 3.9.2, 6.3, 6.8 

Command 6.7.3, 6.9 

INCLUDE Command 6.6.2, 6.6.3 

Initial Program Load (IPL) 6.7.3, 6.8, 6.8.1 

Initialize Disk Surface (IDS) Command . . 2.4.1 
Initialize New Volume (INV) Command . . 2.4.1 

Install Overlay (lO) Command 6.8.4 

Install Procedure (IP) 

Command 3.10,6.6.2,6.8.3 

Install Procedure/Segment SVC 3.10 


Install Program Segment (IPS) 


Command 3.10,6.8.5 

Install Real-Time Task (IRT) Command . .6.8.2 
Install Task: 

Example 9.5 

SVC 3.10,3.11.1,6.7.3 

install Task (IT) Command 3.10, 3.11.1, 

6.6.2, 6.7.3, 6.8.1, 9.5 

Installation: 

Link Editor Image File 6.9 

Overlay 6.8 

Procedure 6.8 

Program 6.8 

Task 6.8 

Installing Programs 1.4 

Instruction: 

BIND 4.6 

BL 4.6 

BLWP 4.6 

Branch and Link (BL) 4.6 

Branch and Load Workspace 

Pointer (BLWP) 4.6 

Branch Indirect (BIND) 4.6 

DXOP 3.5 

Return with Workspace Pointer 

(RTWP) 4.6 

RTWP 4.6 

XOP 3.5 

Interactive: 

Execution 7.4 

Batch Job 2.3.5.3 

Batch Stream 2.3.5.3 

Job 2.2.1 

Interception IPC Use 2.8.2.1 

Internal Registers 8.3.1. 7 

Interprocess Communication 

(IPC) 2.8.1. 3, 2.8.2 

INV Command 2.4.1 

10 Command 6.8.4 

I/O: 

Concepts 3.13.1 

Device 2.8.4, 3.13.2 

Facilities 2.8 

File 2.8.3,3.13.2 

Methods 2.8.1 

Resource-Independent 2.8.1. 2, 3.13.1 

Resource Management 2.8 

Resource-Specific 2.8.1. 1, 3.13.1 

IP Command 3.10,6.6.2,6.8.3 

IPC: 

Channel 2.8.2.2 

Functions: 

Program Level 2.8.2.5 

System Level 2.8.2.4 

Use 2.8.2.1 

Interception 2.8.2.1 

Message 2.8.2.1 

Queue Servicing 2.8.2. 1 

Synchronization 2.8.2. 1 

IPL 6.7.3, 6.8, 6.8.1 
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IPS Command 3.10, 6.8.5 

IRT Command 6.8.2 
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6.7.3, 6.8.1, 9.5 

Job; 

Batch 2.2.2 

Description 2.2 

Interactive 2.2.1 

Execution Batch 2.3.5.3 

Structure 2.2 

Job-Local: 

Channel 2.8.2.3 

LUNO 2.8.4 

JOB NAME Prompt 2.3.2 

KBT Command 3.4 

Key Indexed File (KIF) 2.7.3 

KIF 2.7.3 

Kill Background Task (KBT) Command . . .3.4 

Kill Task (KT) Command 3.4, 8.2.1 

KT Command 3.4, 8.2.1 

LB Command 8.3.1. 1 

LD Command 2.3.4.2 

Level: 

IPC Functions, Program 2.8.2.5 

Overlay 3.9 

Priority 3.11.3 

LIBIN Directive 5.1 

Library Option, Macro 5.1 

Link Editor 1.4, 3.3, 3.9.1, 5.2.4.1 

Command: 

IMAGE Format 6.9 

LOAD 3.9.2 

PARTIAL 6.7.1 

TASK 6.6.4 

Commands 6.2, T6-1 

Control File 6.2 

Example 6.6, 9.4 

Overlay 6.6.4, F6-5 

Single Task, No Procedure . . .6.6.1, F6-2 

Task, Two Attached 

Procedures 6.6.2, F6-3 

Two Procedures 6.6.3, F6-4 

Format Output Option 6.7 

Image File Installation 6.9 

Operation 6.3 

Output: 

Format, Compressed Tagged 

Object 6.7.2 

Format, Memory image 6.7.3 

Format, Normal Tagged Object . . . .6.7.1 

Listing 6.5, F6-1 

Support Features 6.1 

Link Map 6.5 

Linkage Program 6.4 

Module 6.4.4 

Linked; 

Object Code Format 6.7 

Output Suppression 6.3 


Linking Programs 1.4 

List Breakpoints (LB) Command 8.3.1. 1 

List Directory (LD) Command 2.3.4.2 

List Logical Record (LLR) Command . .8.3. 1.2 

List Memory (LM) Command 8.3.1 .3 

List Simulated Breakpoints (LSB) 

Command 8.3.6.3 

List System Memory (LSM) 

Command 8.3.1. 4 

Listing: 

Assembier Cross-Reference 5.1 

Cross-Reference 5.2.3, F5-4 

Exampie, Source F5-1 

Link Editor Output 6.5, F6-1 

Option, Assembler 5.1 

Source 5.2.1 

LLR Command 8.3.1. 2 

LM Command 8.3.1.3 

Load: 

Address 5.2.4. 1 , 5.2.4.4 

Bias 5.2.4.1, 5.2.4.4 

LOAD: 

Directive 5.2.4.1 

Link Edit Command 3.9.2 

Load Overlay SVC 3.9.2, 3.9.3, 6.9 

Loading, Overlay 3.9.2 

Logical; 

Address Space 3.2 

Name 2.3.1, 2.8.4 

Definition 2.6.2 

Tabie 2.3.5.3 

Unit Number 2.8.4, 3.13.2, 6.8, 6.8.1 

Log-On 2.3.2 

LSB Command 8.3.6.3 

LSM Command 8.3.1. 4 

LUNO 6.8, 6.8.1 

Global 2.8.4 

Job-Local 2.8.4 

Task-Local 2.8.4 

Machine Instruction 5.2.1 

Format 5.2.4.2, F5-7 

Source Statement F5-3 

Macro Library Option 5.1 

MAD Command 8.3.2.1 

MADU Command 8.3.2.2 

Main Menu, Default F2-1 

Management: 

I/O Resource 2.8 

SVC, Segment 3.10 

Manager, Automatic Overlay 3.9.2 

Map, Link 6.5 

Mapping F3-1 

Program 3.2 

Master/Slave Channel 2.8.2.2 

Memory: 

Area 8.3.1. 3 

Configuration, Task F3-3 

Image 8.3.2.4 

Disk-Resident 8. 3.1. 9 

FORMAT Command 6.7.3 
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Link Editor Output Format 6.7.3 

System 8.3.2.7 

Memory-Based Segment 3.10 

Memory-Resident: 

Task 3.4.1 

Task Attributes ... 3.1 1 .4, 6.8.1 , 6.8.3, 6.8.5 

Menu, Defauit Main F2-1 

Message: 

Assembier Error 5.2.2 

Assembier Warning 5.2.2 

Error 2.10.1,8.2.2, 8.3.3.1 

Faciiities 2.10 

IPCUse 2.8.2.1 

Oniine Expanded Error 2.10.2 

Status 2.10.3 

Warning 8.3.3.4 

? Response, Error 2.10.2.2 

MIR Command 8.3.2.3 

MM Command 8.3.2.4 

Modification: 

Debug Commands, Data 8.3.2 

Task Attributes 6.8.10 

Modify Absolute Disk (MAD) 

Command 8.3.2.1 

Modify Allocatable Disk Unit 

(MADU) Command .8.3.2.2 

Modify Internal Registers (MIR) 


Command 8.3.2.3 

Modify Memory (MM) Command .... .8.3.2.4 


Modify Cverlay Entry (MCE) 

Command 6.8.12 

Modify Procedure Entry (MPE) 

Command 6.8.11 

Modify Program Image (MPI) 

Command 8.3.2.5 

Modify Relative to File (MRF) 

Command 8.3.2.6 

Modify Segment Entry (MSE) 

Command 6.8.13 

Modify Synonym (MS) Command 2.6.1 

Modify System Memory (MSM) 

Command 8.3.2.7 

Modify Task Entry (MTE) Command . . .6.8.10 
Modify Workspace Registers (MWR) 

Command 8.3.2.8 

Module: 

Identifier 8.2.2 

Linkage, Program 6.4.4 

MCE Command 6.8.12 

MPE Command 6.8.11 

MPI Command 8.3.2.5 

MRF Command 8.3.2.6 

MRW Command 8.3.2.8 

MS Command 2.6.1 

MSE Command 6.8.13 

MSM Command 8.3.2.7 

MTE Command 6.8.10 

Multiple Copies 2.8.5 

Multivolume File 2.7.4 

MUNLST Assembler Cption 5.1 


No Debugging, Execute 9.8 

NCLIST Assembler Cption 5.1 

Normal: 

Tagged: 

Object FORMAT Command 6.7.1 

Object Link Editor Output 

Format 6.7.1 

Task Termination 3.4.1 

Notation: 

Field Prompt T1-2 

Response 1.7 


Object Code 5.2.4 

change 5.2.4.4 

Example F5-5 

Format 5.2.4.1 

Linked 6.7 

Symbol Table 8.3.4.4, F9-1 

Object: 

FORMAT Command: 

Compressed Tagged 6.7.2 

Normal Tagged 6.7.1 

Link Editor Output Format: 

Compressed Tagged 6.7.2 

Normal Tagged 6.7.1 

Record: 

Format T5-2 

Tags T5-2 

Online Expanded Error Message 2.10.2 

Option: 

Assembler: 

Listing 5.1 

Output 5.1 

BUNLST Assembler 5.1 

DUNLST Assembler 5.1 

FUNL Assembler 5.1 

Link Editor Format Output 6.7 

Macro Library 5.1 

MUNLST Assembler 5.1 

NOLIST Assembler 5.1 

RXREF Assembler 5.1 

Symbol Table 

Assembler 5.1 , 5.2.4.1 , 5.2.4.3 

SYMT Assembler 5.1 , 5.2.4.3, 8.2.2, 

8.3.4.4, 9.1, 9.6 

TUNLST Assembler 5.1 

XREF Assembler 5.1 

990/12 Assembler 5.1 

Output: 

Cover Page Example F5-2 

Format: 

Compressed Tagged Object Link 

Editor 6.7.2 

Memory Image Link Editor 6.7.3 

Normal Tagged Object Link 

Editor 6.7.1 

Listing, Link Editor 6.5, F6-1 

Option: 

Assembler 5.1 

Link Editor Format 6.7 


2270508-9701 


Index-9 



Index 


Suppression, Linked 6.3 

Overfiow Task Attributes, 

Arithmetic 3.11.10,5.2.2,6.8.1 

Overiay 3.9, 6.8 

Installation 6.8 

Levei 3.9 

Link Editor Exampie 6.6.4, F6-5 

Loading 3.9.2 

Manager, Automatic 3.9.2 

Path 3.9 

Phase 3.9 

Relocatable 3.9.3 

Root Phase 3.9 

Structure 3.9 

Page Title (TITL) Directive 4.6 

Panel: 

Debug 8.3.1. 8, 8.3.3.2 

Display F9-2 

PARTIAL Link Editor Command 6.7.1 

Path Overiay 3.9 

Pathname Definition 2.5 

PB Command 8.2, 8.3.3.1 , 8.3.3.3, 

8.3.3.4, 8.3.4.3, 8.3.6.4, 9.7 

Phase 3.9.1 

Overiay 3.9 

Root 3.9 

Physical Address Space 3.2 

Primitive: 

.BID 8.2.1 

.DATA 2.3.5.4 

.DBID 8.2.1 

.EOD 2.3.5.4 

.QBID 8.2.1 

.USE 2.3.1 

Priority 2.8.5 

Level 3.11.3 

Task Attributes 3.11.3, 6.8.1 

Privileged: 

Task Attributes 3.11.1,6.8.1 

Hardware 3.11.1.1 

Software 3.11.1.2 

User 2.3.2 

PROCEDURE Command 3.8 

Procedure: 

Installation 6.8 

Pure 3.8 

Reentrant 3.7, 3.8 

Segment 3.3, 3.7, 6.8.3 

Segments, Shared 3.7 

Shared .3.7, 3.8, 6.8 

Proceed from Breakpoint 

(PB) Command 8.2, 8.3.3.1, 8.3.3.3, 

8.3.3.4, 8.3.4.3, 8.3.6.4, 9.7 

Program 3.1 

Directive 6.4 

Exampie, Assembly Language . . .9.1, F4-1 

Execution 7.1 

SVC 7.3 

File 2.7.2, 3.9.3, 3.10, 6.7.3, 6.8, 6.8.1 

Default 6.8 


.S$SHARED 3.8,3.11.4,6.8 

.S$UTIL 3.11.4,6.8 

Image 8.3.2.5 

Installation 6.8 

Level IPC Functions 2.8.2.5 

Linkage 6.4 

Mapping 3.2 

Moduie Linkage 6.4.4 

Segment 3.10,6.8.5 

Segmentation 3.3 

Program Identifier (IDT) Directive . . .4.6, 6.4.3 

Program-Reiocatable 5.2.4.1 

Program Segment (PSEG) Directive 4.6 

Programming: 

Reentrant 3.8 

Techniques 4.6 

Programs: 

Assembiing 1.3, 9.3 

Debugging 1.6 

Entering 1.2, 2.3.5.4 

Executing 1.5 

Installing 1.4 

Linking 1.4 

Prompt: 

Account ID 2.3.2 

JOB NAME 2.3.2 

Notation, Field T1-2 

RECONNECT 2.3.2 


Protected Task Attributes 3.1 1 .6, 6.8.1 , 

6.8.3, 6.8.4, 6.8.5 


Delete 3.11.6.1 

Execute 3.11.6.2 

PSEG Directive 3.8, 4.6 

Pure Procedure 3.8 


Q Command 4.3 

QD Command 8.2.1, 8.3.6.4, 9.6 

QE Command 4.1, 4.5.1, 4.5.2 

Queue Servicing IPC Use 2.8.2.1 

Quit Debug Mode (QD) 

Command 8.2.1, 8.3.6.4, 9.6 

Quit Edit (QE) Command 4.1, 4.5.1, 4.5.2 

Quit (Q) Command 4.3 


Real-Time Task 

RECONNECT Prompt 
Record: 

Format, Object . . . , 

Tags, Object 

Reentrant: 

Procedure 

Programming .... 

REF Directive 

Reference: 

External 

I S^J. 


6.8.10 

2.3.2 

T5-2 

T5-2 

3.7, 3.8 

3.8 

. . . .4.6, 6.4.1, 6.4.4 

5.2.4.1,5.2.4.4, F5-6 
. .6.4.4 
8.3.1.7 
. .2.7.2 


Registers, Internai 

Relative Record File 

Release LUNO (RL) Command 9.8 

Relocatable: 

Address 5. 2.4.1, 5.2.4. 4 
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Data 5.2.4.1 

Data Word 5.2.4.4 

Overlay 3.9.3 

Replace String (RS) Command 4.5.2 

Replicatable Task 

Attributes 3.11.5,6.8.1,6.8.5 

Resource-Independent I/O .... 2.8.1 .2, 3.13.1 

Resource Management, I/O 2.8 

Resource-Specific I/O 2.8.1. 1, 3.13.1 

Response: 

Notation 1.7 

Type Indicators T1-1 

Resume Simulated Task 
(RST) Command . . . .8.3.6.1, 8.3.6.5, 8.3.6.6 
Resume Task (RT) 


I II I Idl I ) 

8.3.4.3, 8.3.4.5, 8.3.6.4, 9.6 
Return with Workspace Pointer 

(RTWP) Instruction 4.6 

Reusable Task 

Attributes 3.11.8, 6.8.1, 6.8.5 

RL Command 9.8 

Root Phase Overlay 3.9 

RS Command 4.5.2 

RST Command 8.3.6.1, 8.3.6.5, 8.3.6.6 


I 1 I V^V^I I II I IGII IV4 I , 

8.3.4.3, 8.3.4.5, 8.3.6.4, 9.6 

RTWP Instruction 4.6 

Run-Time ID 3.1 

RXREF Assembler Option 5.1 

SAD Command 8.3.1. 5 

SADU Command 8.3.1.6 

SBS Command 2.3.4.1 

SCI 2.3.1 

Activating 2.3.2 

Command: 

Entry 2.3.3 

Usage 4.3 

Exampie 2.3.4 

SDSMAC Assembler 1.1 

Search Debug Commands 8.3.5 

Secondary External Reference 

(SREF) Directive 5.2.4.1 

Segment 2.9, 3.2 

common 4.6, 5.2.4.1 

Data 5.2.4.1 

Memory-Based 3.10 

Procedure 3.3, 3.7, 6.8.3 

Program 3.10, 6.8.5 

Single Task 3.3.1 

Task 3.2, 3.3, 3.6, 3.7, 6.8.1 

Segment Management SVC 3.10 

Segmentation, Program 3.3 

Segments: 

Disk- Based 3.10 

Shared 3.2, 6.8.5 

Procedure 3.7 

Single 3.3 

Task Shared F3-2 


Selection: 

Command 4.2 

Format 2.8.5 

SEM Command 2.10.2.1 

Sequential File 2.7.1 

SF Command 9.6 

Shared: 

Procedure 3.7, 3.8, 6.8 

Segments 3.7 

Segments 3.2, 6.8.5 

F3-2 

Show Absolute Disk (SAD) 

Command 8.3.1. 5 

Show Allocatable Disk Unit (SADU) 

Command 8.3.1. 6 

Show Background Status (SBS) 

Command 2.3.4.1 

Show Expanded Message (SEM) 

Command 2.10.2.1 

Show File (SF) Command 9.6 

Show Internal Registers 

(SIR) Command 8.3.1 .7, 8.3.3.1 , 9.7 

Show Line (SL) Command 4.2 

Show Panel (SP) 

Command 8.3.1. 8, 8.3.1.12, 8.3.3.1, 9.7 

Show Program Image (SPI) 

Command 8.3.1.9 

Show Relative to File (SRF) 

Command 8.3.1.10 

Show Task Status (STS) 

Command 8.2.1, 8.3 

Show Value (SV) Command 8.3.1 .1 1 

Show Workspace Registers (SWR) 

Command 8.3.1.12 

Simulate Debug Commands 8.3.6 

Simulate Task (ST) Command .... 8.3.6.5, 9.6 
Simulated: 

Breakpoint 8.3.6.1 

Execution 8.3.6.6 

Single: 

Segments 3.3 

Task, No Procedure Link Editor 

Example 6.6.1, F6-2 

Task Segment 3.3.1 

SIR Command 8.3.1 .7, 8.3.3.1 , 9.7 

SL Command 4.2 

Slicing, Time 3.11.3, 8.3.4.2 

Snapshot Name Definitions 

(SND) Command 2.3.5.3 

SND Command 2.3.5.3 

Software Privileged Task 

Attributes 3.11.1.2 

Source: 

Listing 5.2.1 

Example F5-1 

Statement, Machine Instruction F5-3 

SP Command 8.3.1.8,8.3.1.12,9.7 

Space: 

Logical Address 3.2 

Physical Address 3.2 
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Special Symbols 8.2.3 

SPI Command 8.3.1.9 

Spooling 2.8.5 

SREF Directive 6.4.1 

SRF Command 8.3.1.10 

ST Command 8.3.6.5, 9.6 

Station-Dependent Displays 8.4 

Status Message 2.10.3 

String 8.3.4.4 

Character 8.2.3 

STS Command 8.2.1, 8.3 

Subroutine Call Techniques 4.6 

Supervisor Call 3.4, 3.5 

Block 3.5 

Support Features, Link Editor 6.1 

Suppression, Linked Output 6.3 

Suspend, Unconditional 8.2.1, 8.3.3.1, 

8.3.4.1, 8.3.4.2 

Suspended Debug, Unconditionally 8.2 

SV Command 8.3.1.11 

SVC 3.4 

Assign LUNO 2.8.4 

Create IPC Channel 2.8.2 

Create Logical Name 2.7.4 

Create Segment 3.10 

Delete Task 3.11.4 

End Action Status 3.4.2 

End Task 3.4.1 

Install Procedure/Segment 3.10 

Install Task 3.10,3.11.1,6.7.3 

Load Overlay 3.9.2, 3.9.3, 6.9 

Program Execution 7.3 

Segment Management 3.10 

SWR Command 8.3.1.12 

Symbol: 

Attributes T5-1 

Table 5.2.4.3 

Assembler Option . . . 5.1, 5.2.4.1, 5.2.4.3 

Object Code 8.3.4.4, F9-1 

Symbolic: 

Constants 8.2.3 

Debug 8.2.2 

Debugging Example, Execute 9.6 

Expression 8.2, 8.3.4.4 

Symbols, Special 8.2.3 

Symmetric Channel 2.8.2.2 

SYMT Assembler Option . . .5.1, 5.2.4.3, 8.2.2, 

8.3.4.4, 9.1, 9.6 

Synchronization IPC Use 2.8.2.1 

Synonym 2.3.1 

Definition 2.6.1 

Table 2.3.5.3 

System: 

Image File 6.7.3 

Memory 8.3.2.7 

Task Attributes 3.11.2,6.8.1 

System Level IPC Functions 2.8.2.4 

Tag Character 5. 2.4.1 

A 5.2.4.1,5.2.4.4 

B 5.2.4.1,5.2.4.4 


C 5.2.4.1,5.2.4.4 

D 5.2.4.1 

E 5.2.4.1 

F 5.2.4.1 

G 5.2.4.1,5.2.4.3 

H 5.2.4.1,5.2.4.3 

I 5.2.4.1 

J 5.2.4.1 

M 5.2.4.1 

N 5.2.4.1,5.2.4.4 

P 5.2.4.1,5.2.4.4 

Q 5.2.4.1 

R 5.2.4.1 

S 5.2.4.1,5.2.4.4 

T 5.2.4.1 

U 5.2.4.1 

V 5.2.4.1 

W 5.2.4.1 

X 5.2.4.1 

Y 5.2.4.1 

Z 5.2.4.1 

0 5.2.4.1,5.2.4.4 

1 5.2.4.1 

2 5.2.4.1 

3 5.2.4.1 

4 5.2.4.1,5.2.4.4 

5 5.2.4.1,5.2.4.4 

6 5.2.4.1,5.2.4.4 

7 5.2.4.1,5.2.4.4 

8 5.2.4.1,5.2.4.4 

9 5.2.4.1,5.2.4.4 

Tagged Object: 

FORMAT Command: 

Compressed 6.7.2 

Normal 6.7.1 

Link Editor Output Format: 

Compressed 6.7.2 

Normal 6.7.1 


Tags, Object Record T5-2 

Task 3.1, 3.3, 6.8 

Abnormal Termination 3.4.2 

Activate 8.3.4.3 

Background 2.2.1, 2.3.5 

Commands, Controlled 8.3.6 

Control Debug Commands 8.3.4 

Disk-Resident 3.4.1 

Foreground 2.2.1 

Installation 6.8 

Memory Configuration F3-3 

Memory-Resident 3.4.1 

Real-Time 6.8.10 

Segment 3.2, 3.3, 3.6, 3.7, 6.8.1 

Single 3.3.1 

Shared Segments F3-2 

Single with no Procedure 

Link Editor Example 6.6.1 , F6-2 

Termination 3.4, 3.12 

Normal 3.4.1 


Two Attached Procedures 

Link Editor Example 6.6.2, F6-3 
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Task Attributes 3.11, 6.8.1 

Arithmetic Overfiow . . .3.11.10, 5.2.2, 6.8.1 

Controi Storage 3.11.11 

Copyabie 3.11.7,6.8.1,6.8.5 

Deiete Protected 3.11.6.1 

Disk-Resident 3.11.4 

Execute Protected 3.11.6.2 

Hardware Priviieged 3.11.1.1 

Memory-Resident 3.1 1 .4, 6.8.1 , 

6.8.3, 6.8.5 


Modification 6.8.10 

Priority 3.11.3,6.8.1 

Priviieged 3.11.1, 6.8.1 

Protected ... 3.1 1 .6, 6.8.1 , 6.8.3, 6.8.4, 6.8.5 

Repiicatabie 3.1 1 .5, 6.8.1 , 6.8.5 

Reusabie 3.11.8,6.8.1,6.8.5 

Software Priviieged 3.11.1.2 

System 3.11.2,6.8.1 

Updatabie 3.11.9, 6.8.1, 6.8.5 

Writabie Controi 


Store 3.11.11,6.8.1,6.8.3,6.8.5 

990/12 6.8.1, 6.8.3, 6.8.5 

TASK Command 6.6.2 

TASK Link Edit Command 6.6.4 

Task-Locai: 

Channei 2.8.2.3 

LUNO 2.8.4 


Techniques: 

Programming 4.6 

Subroutine Caii 4.6 

Terminai Usage 4.2 

Termination: 

Normai Task 3.4.1 

Task 3.4,3.12 

Abnormai 3.4.2 

TEXT Directive 5.1 

Text Editor: 

Commands T4-1 

Exampie 4.5 

Review 9.2 

Use 4.1 

TimeSiicing 3.11.3,8.3.4.2 

TiTL Directive 4.6 

TUNLST Assembier Option 5.1 

Two Procedure Link Editor 

Exampie 6.6.3, F6-4 


Unconditionai Suspend 8.2.1, 8.3.3.1, 

8.3.4.1, 8.3.4.2 

Unconditionaiiy Suspended Debug 8.2 

Unit Number, Logicai . . 2.8.4, 3.13.2, 6.8, 6.8.1 


Updatabie Task 

Attributes 3.11.9, 6.8.1, 6.8.5 


User-Defined Command 2.3.1 

VCATALOG Directory 2.4.2 

VDTMode 2.3.3 

Vector, Entry 3.6 

Voiume (iNV) Command, Initialize 

New 2.4.1 

Volume Name 2.4.1 


Warning Messages. . . . 

Assembler 

Word 

Boundary 

Data 

Workspace 

Register 

Writable Control Store 


8.3.3.4 

5.2.2 

8.3.1.10 

8.3.5.2 

,5.2.4.1,5.2.4.4 

8.3.1.12 

8.3.2.8 


Task Attributes . . 3.1 1 .1 1 , 6.8.1 , 6.8.3, 6.8.5 


XB Command 2.3.5, 2.3.5.3, 5.3.2 

XBJ Command 2.3.5, 2.3.5.3, 5.3.3 

XCT Command 2.3.1 

XD Command 8.2, 8.2.1 , 8.2.2, 8.3.4.4 

XE Command 4.1, 4.5.1, 4.5.2 

XHT Command 7.2.3, 8.2.1, 

8.3.4.4, 8.3.4.5, 9.6 

XLE Command 2.3.5.2, 6.3, 9.4 

XMA Command 5.1, 9.3 

XOP Instruction 3.5 

XPT Command 2.3.1 

XREF Assembler Option 5.1 

XT Command 2.3.1, 7.2.1, 8.2.1 

XTS Command 7.2.2, 9.8 


990/12: 

Assembler Option 5.1 

Task Attributes 6.8.1 , 6.8.3, 6.8.5 


.BID Primitive 8.2.1 

.DATA Primitive 2.3.5.4 

.DBID Primitive 8.2.1 

.EOD Primitive 2.3.5.4 

.QBID Primitive 8.2.1 

.S$SHARED Program File 3.8, 3.1 1 .4, 6.8 

.S$UTIL Program File 3.11.4,6.8 

.USE Primitive 2.3.1 


? Response, Error Message 2.10.2.2 
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Task Attributes 3.11, 6.8.1 

Arithmetic Overflow . . .3.11.10,5.2.2,6.8.1 

Control Storage 3.1 1 .1 1 

Copyable 3.11.7,6.8.1,6.8.5 

Delete Protected 3.1 1 .6.1 

Disk-Resident 3.11.4 

Execute Protected 3.11.6.2 

Hardware Privileged 3.11.1.1 

Memory-Resident 3.1 1 .4, 6.8.1 , 

6.8.3, 6.8.5 

Modification 6.8.10 

Priority 3.11.3,6.8.1 

Privileged 3.1 1.T, 6.8.1 

Protected . . .3.11.6,6.8.1,6.8.3,6.8.4,6.8.5 

Replicatable 3.11.5, 6.8.1, 6.8.5 

Reusable 3.11.8,6.8.1,6.8.5 

Software Privileged 3.11.1.2 

System 3.11.2,6.8.1 

Updatable 3.11.9, 6.8.1, 6.8.5 

Writable Control 

Store 3.11.11,6.8.1,6.8.3,6.8.5 

990/12 6.8.1, 6.8.3, 6.8.5 

TASK Command 6.6.2 

TASK Link Edit Command 6.6.4 

Task- Local: 

Channel 2.8.2.3 

LUNO 2.8.4 


Techniques: 

Programming 4.6 

Subroutine Call 4.6 

Terminal Usage 4.2 

Termination: 

Normal Task 3.4.1 

Task 3.4,3.12 

Abnormal 3.4.2 

TEXT Directive 5.1 

Text Editor: 

Commands T4-1 

Example 4.5 

Review 9.2 

Use 4.1 

Time Slicing 3.11.3,8.3.4.2 

TITL Directive 4.6 

TUNLST Assembler Cption 5.1 

Two Procedure Link Editor 

Example 6.6.3, F6-4 


Unconditional Suspend 8.2.1, 8.3.3.1, 

8.3.4.1, 8.3.4.2 

Unconditionally Suspended Debug 8.2 

Unit Number, Logical . . 2.8.4, 3.13.2, 6.8, 6.8.1 


Updatable Task 

Attributes 3.11.9, 6.8.1, 6.8.5 

User-Defined Command 2.3.1 


VCATALCG Directory 2.4.2 

VDTMode 2.3.3 

Vector, Entry 3.6 

Volume (INV) Command, Initialize 

New 2.4.1 

Volume Name 2.4.1 


Warning Messages. . . . 

Assembler 

Word 

Boundary 

Data 

Workspace 

Register 

Writable Control Store 


8.3.3.4 

5.2.2 

8.3.1.10 

8.3.5.2 

,5.2.4.1,5.2.4.4 

8.3.1.12 

8.3.2.8 


Task Attributes . . 3.1 1 .1 1 , 6.8.1 , 6.8.3, 6.8.5 


XB Command 2.3.5, 2.3.5.3, 5.3.2 

XBJ Command 2.3.5, 2.3.5.3, 5.3.3 

XCT Command 2.3.1 

XD Command 8.2, 8.2.1 , 8.2.2, 8.3.4.4 

XE Command 4.1, 4.5.1, 4.5.2 

XHT Command 7.2.3, 8.2.1, 

8.3.4.4, 8.3.4.5, 9.6 

XLE Command 2.3.5.2, 6.3, 9.4 

XMA Command 5.1, 9.3 

XOP Instruction 3.5 

XPT Command 2.3.1 

XREF Assembler Option 5.1 

XT Command 2.3.1, 7.2.1, 8.2.1 

XTS Command 7.2.2, 9.8 


990/12: 

Assembler Option 5.1 

Task Attributes 6.8.1 , 6.8.3, 6.8.5 


.BID Primitive 8.2.1 

.DATA Primitive 2.3.5.4 

.DBID Primitive 8.2.1 

.EOD Primitive 2.3.5.4 

.QBID Primitive 8.2.1 

.S$SHARED Program File 3.8, 3.1 1.4, 6.8 

.S$UTIL Program File 3.11.4,6.8 

.USE Primitive 2.3.1 


? Response, Error Message 2.10.2.2 
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